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1.0 Introduction 


To order this document, request SV40-0089-01. This document 1s also available in 
the following places: 


* OS2BBS -- the IBM bulletin board accessible through IIN. 


— MPCONFIG.ZIP -- The Postscript version, the ASCII text version, the 
LIST3820 version, and the sample files. 


¢ MKTTOOLS -- the IBM-internal bulletin board with packages available for 
distribution to customers.. Most marketing reps and SE’s have access to this 
bulletin board. 


— MPCONFIG PACKAGE -- contains the Postscript, ASCII text, and a 
LIST3820 version of the document, as well as the sample files. 

This booklet explains how to configure APPC and APPN on the following plat- 
forms: 

¢ Networking Services/DOS 

« OS/2 Extended Services 

¢ Communications Manager/2 1.1 
-¢ RISC System/6000 SNA Services 

¢ RISC System/6000 SNA Server/6000 

° VM 

¢ CICS 

° MVS 

¢ OS/400 

¢ 3174 
(See the individual chapters for details on product versions and prerequisites.) 
To configure APPC on different kinds of computers you need to know multiple 
configuration methods. Terminology varies from one type of computer to another. 
There is a set of values that needs to match between two computers that want to 
communicate. 
This guide is designed to do three things: 

1. Describe the steps needed to configure APPC. 


2. Explicitly state which values in one computer's configuration need to match 
values 1n a partner computer’s configuration. 


3. Clarify the terminology differences between computers by mapping to a set of 
standard terms, and confining platform-specific terms to the section that 
describes that platform. 


This guide 1s not a tutonal on APPC or APPN concepts, although some APPC and 
APPN terms are introduced in this first section: It is also not a network design 
tutorial. A good introduction to APPC and APPN concepts is provided in two 
publications: Networking with APPN: An Overview, G325-0204-00 and Communi- 
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cating with APPC and CPI-C: A Technical Overview, G325-0202-00. Both are avail- 
able from IBM. 


To keep things simple, configuration for a token-rng Local Area Network is explic- 
itly presented in this booklet. The information here should help you configure other 
types of networks, but additional information from the platform’s installation guide 
may be necessary in those cases. 


This guide uses a widely available APPC program named APING in the configura- 
tion examples. APING is a small program that sends data across a network and 
receives data back. APING is used to test connectivity between two machines on a 
network, and to provide diagnostic information when APPC communications fail. 
APING 1s shipped as a sample program with Networking Services/DOS and Com- 
munications Manager/2. It is also available on several bulletin boards: 


¢ CompuServe 


There is an APPC Info Exchange forum on CompuServe (type GO APPC to 
access this forum). In the Sample Programs Library section, there are several 
packages related to APING: 


— APING.ZIP - The OS/2 APING executables, C source code, and makefiles 
for many platforms. 


— APINGS.ZIP - The Cc source portion of the APING.ZIP package. 

— PNGFAM.ZIP - The executables from the APING.ZIP package. 

— APINGC.ZIP - the CICS COBOL source for the APINGD server. 
¢ MKTTOOLS | 


MKTTOOLS is an IBM-internal bulletin board containing packages that can 
be distnbuted to customers. IBM marketing reps and SE’s have access to this 

- bulletin board and can request packages from it. The packages related to 
APING are: 


— APING PACKAGE: The OS/2 APING executables, C source code, and 
makefiles for many platforms. 


— APINGCIC PACKAGE: the CICS COBOL source for the APINGD 
server. 


¢ OS2BBS 


The OS2BBS 1s a bulletin board accessible through IBM Information Network. 
You can acquire and register for the service by calling 1-800-547-1283. The 
APING package is available on the OS2BBS. 


— APING.ZIP: The OS/2 APING executables, C source code, and makefiles 
for many platforms. 


The APING package consists of a client program, APING, and a server program 
APINGD. We recommend that you obtain APING and use it when you configure 
APPC in your network. 


When you finish configuring both partners, run APING on the client machine. 
When APING successfully exchanges information with a partner, the following 
information (with tuming variations) is displayed. 


DP NA Tulti-Platform Canfie 


APING version 2.35 APPC echo test with timings. 


by Peter J. Schwaller (pjs@ralvm6.vnet.ibm.com) 


Allocate duration: 1711 ms 


Program startup and Confirm duration: 689 ms 


Duration Data Sent Data Rate Data Rate 
(msec) (bytes) (KB/s) (Mb/s) 


Totals: 60 


Duration statistics: 


Figure 1. Results from APING 


1.2 Using this guide 


This guide contains a chapter for each platform. Each chapter describes that plat- 
form’s configuration independent of the type of machine it will be connecting to. 
Within each chapter, when parameter values are needed from a partner computer, 
the instructions will say: “See the “How to find...’ section of the partner computer’s 
configuration chapter.” The person using that partner computer’s configuration 
chapter should be able to read the ‘How to find...’ instructions and provide the 
proper value. 


Each chapter assumes some knowledge of the operation of that platform. No 
APPC or APPN knowledge is required, but someone configuring Networking 
Services/DOS needs to know how to edit a text file in DOS, and how to copy files, 
for example. 


If there are different people configuring different platforms, for example, when trying 
to connect OS/2 to an AS/400, this 1s what you should do: 


1. 
2 
3. 


Give the chapter on OS/2 to the person configuring OS/2. 
Give the OS/400 chapter to the person configuring OS/400. 


Each person fills in the values in the platform Configuration Worksheet at the 
beginning of their chapter. You need to obtain specific values from the person 
who 1s configuring the platform that you want to connect to. Instructions for 
finding this information are in the “How to find...” section of their chapter. 


. Each person follows the configuration directions in their chapter, filling in the 


appropniate values from the Configuration Worksheet. 


If you need more details about a platform’s configuration, you should refer to 


- documents listed at the beginning of each chapter. 


In this manner, the OS/2 configurerr never needs to learn the AS/400 configuration 
terminology (unless the same person is the configurer of both machines). 


Each chapter in this booklet is not only independent of the partner computer's plat- 
form, but also independent of the network structure. This means that the con- 
nection between computers is described as a direct connection from one computer 
to the other. However, configuration can get complex when a computer starts con- 
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necting to several partner computers. This complexity is unnecessary when a special 
kind of node called a network node 1s added to the network. A network node 1s 
used to locate partners in a network. (Network nodes are discussed in more detail in 
1.9, “What Is APPN?” on page 6.) 


If you have an APPN network node in your network, you should define just one 
link to it, and avoid defining the many individual links to the other computers in the 
network that can be located by the network node. The chapter for each platform 
describes how to substitute a link to a network node for many direct links to partner 
machines. The way to find out if you have a network node in your network is to 
ask someone who set up the network. That person should be able to provide you 
with the necessary information about the network node for you to include it in your 
configuration. If you don’t have a network node, or don’t know if you have one, 
you can continue to follow the directions that assume there is no network node. 

The only drawback is that this may add unnecessary complexity to your network. 


1.3. What Is APPC? 


Advanced Program-to-Program Communication (APPC) 1s software that enables 

high-speed communications between programs on different computers, from port- 
ables and workstations to midrange and host computers. APPC software is avail- 
able for many different IBM and non-IBM operating systems, either as part of the 
operating system or as a separate software package. | 


APPC serves as a translator between application programs and the network. When 
an application on your computer passes information to the APPC software, APPC 
translates the information and passes it to a network interface, such as a LAN 
adapter card. The information travels across the network to another computer, 
where the APPC software receives the information from the network interface. 
APPC translates the information back into its original format and passes it to the 
corresponding partner application. 


1.4 What are Transaction Programs and Conversations? 


A 


The part of an application that initiates or responds to APPC communications is 
called a transaction program or TP. A transaction program on your workstation 1s 
not an entire, stand-alone program. Instead, it is the part of the program that 
handles transactions (exchanges of data) with another program. 


When people talk with each other, we say that they are having a conversation. 
Likewise, the communication between two transaction programs 1s called a comver- 
sation. 


A conversation between two programs is similar to conversation between two 
people. When you have a conversation with another person, you follow unwnitten 
rules that govern how you begin and end the conversation, take turns speaking, and 
exchange information. Similarly, APPC is called a protocol because it provides the 
rules that govern how conversations between transaction programs start and stop, 
which program “speaks” first, and how data 1s exchanged. 


A program in your computer may have several conversations active at one time, 
with the same transaction program or with different transaction programs. 
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1.5 What are Logical Units and Sessions? 


When two people in different buildings want to talk to each other, they must use 
their telephones. Similarly, transaction programs in different computers can’t talk 
directly to each other. Instead, they converse over sessions between two logical 
units. 


A logical unit or LU is APPC software that serves as an interface or translator 
between a transaction program and the network. A logical unit manages the 
exchange of data between transaction programs.. 


An LU 1s located on your computer. A partner LU is located on a partner com- 
puter. 


Before a transaction program can start a conversation with a partner transaction 
program, APPC must establish a session, the session that connects the local LU and 
the partner LU. 


There is a one-to-one relationship between a conversation and a session. A session 
can support only one conversation at a time. However, as soon as that conversa- 
tion ends, another conversation can use the session. So, compared to conversations, 
sessions are long-lived connections. 


1.6 What Is a Mode? 


A mode is a set of parameters that defines the characteristics of a session between 
two LUs. Modes have names that must match exactly. There are 4 modes prede- 
fined on most platforms that can be used by most applications. (Two more modes, 
SNASVCMG and CPSVCMG, are also defined, but they are not intended to be 
used directly by applications.) The SC suffix in the mode name means the defi- 
nitions include security. 


© #INTER_ - for interactive jobs 

¢ #BATCH : for batch jobs 

¢ #INTERSC - for interactive jobs with security 
¢ #BATCHSC - for batch jobs with security 


1.7 What Is CPI-C side information? 


CPI-C, Common Programming Interface Communications, provides a consistent 
application programming interface for network applications. 


CPI-C programming provides a mechanism, called side information, which associ- 
ates a set of parameters with a specified symbolic destination name. The CPI-C 
program then uses the symbolic destination name to initialize a conversation. This 
information includes: 


CPI-C Symbolic destination name 
The name used to refer to the CPI-C side information entry. 


TP name 
The name used to identify which program to start on the partner computer. 
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LU name 
The name of the partner LU 


mode name 
The characteristics associated with the session between the LUs. 


1.8 What Is a Network? 


Transaction programs in different computers must use a network to communicate 
with each other. APPC provides the interface between the programs and net- 
working software and hardware. 


In simplest terms, a network consists of components that connect computers. 
These components are: 


Node | 
A node is any computer in the network. For example, if your DOS work- 
station is connected to an OS/2 workstation, both computers are nodes. 
Link | 

A link is a physical or logical connection between two adjacent nodes. 


Before data can be sent between two nodes, a link must be active between them. 
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Advanced Peer-to-Peer Networking (APPN) provides networking functions for 
APPC applications. 


When configuring a node in a network, you must decide which type of node to con- 
figure. Types of nodes in an APPN network are: 


Low-entry networking node (LEN) 
Low-entry networking nodes are the sumplest node type and have the least 
function. A low-entry networking node must be an end point in the network; 
it cannot function as an intermediate node. A LEN 1s capable of peer-to-peer 
communication, but unable to make direct use of APPN functions. Most 
end-user computers should be EN’s. However, some platforms can only be 
LEN nodes, e.g., NS/DOS. 


End node (EN) 
An end node provides the functions of a low-entry networking node plus the 
ability to register information about itself with a network node. This ability 
helps reduce the amount o+ network configuration required. 


Network node (NN) 
NN’s are used to locate partners in an APPN network. If there is a NN in 
the network, an end node can define one link to the network node. The EN 
then requires no other link definitions. Typically, there is at least one network 
node in a network but the addition of more requires informed network anal- 
ysis. | 


How do I Configure a Network? 


1.9.1 What is a Control Point(CP) ? 
In APPN, a control point is responsible for managing the node and its resources 
and, in an APPN end node, for communicating with an adjacent network node 
server's control point to obtain APPN network services. A control point is an LU 
and it might be the only LU at that node. Whenever possible the CP should be the 
only LU at anode. Platforms that are LEN only do not use the control point. 


1.9.2 What is Subarea Networking? 
Subarea networks existed pnor to APPN. As opposed to APPN, subarea networks 
are hierarchical in nature. The software that implements subarea networks runs in 
host computers and communication controllers attached to those hosts. The host 
software is called VTAM (Virtual Telecommunications Access Method), and the 
communication controller software 1s called NCP (Network Control Program). 


Nodes in APPN networks can have links to subarea networks and can establish ses- 
sions and conversations with LUs and TPs in those networks. From the perspective 
of the APPN node the entire subarea network is viewed as a LEN node. Resources 
in the subarea network can then be defined in the APPN node as though they all 
were contained in one LEN node. 


1.9.3 What is a Node Identifier? 
Note: Some SNA products require partner systems to code a specific value for a 
parameter called the node identifier or node id for short. The two systems pass this 
node identifier during the link activation in a message unit called exchange identifi- 
cation or “XID.” Node identifiers for each specific platform are described in the 
appendix. See Appendix A, “Using Node IDs in VTAM)” on page 143. 


We discourage use of node identifiers, preferring the CP name because it is more 
generic and less confusing. 


1.10 How do I Configure a Network? 


This section provides an overview of the steps required to configure APPC. Config- 
uration is described by using a standard terminology. These standard terms are used 
throughout the guide to discuss configuration. Each platform may use platform- 
specific terms in its configuration instead of the standards tems. Therefore, each 
chapter contains a terminology mapping chart that cross-references the terms below 
with platform-specific terms. 


The steps to APPC configuration are: 
¢ Define yourself to the network. 
To define yourself to the network, you must define these parameters: 
— Network Name | 


A network 1s a set of interconnected nodes that are grouped by a common 
identifier called a network name. The network name is a 1| to 8 character 
field consisting of alphanumeric characters. There is a structured format for 
the network name which includes the country code, enterprise code and 
network suffix code. This format insures uniqueness around the world. 

Call your local IBM branch office for the format information and to register 
your network name. 
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— LU name 


1 to 8 character field consisting of alphanumeric characters which is the LU 
name of the node. Choose a name that is unique within the network name. 


The fully qualified name is represented as two concatenated names, the network 
name and the LU name, separated by a period (NETNAME. LUNAME). ‘This 
unique name identifies the node. 


Define a link to your partner 


— You can define a direct link between the local node and the partner node if 
both nodes are in the same local network. 


— If there 1s a network node (NN) in the local network, you can define a link 
to the NN, and the NN can locate the partner node. 


— Ifthe partner node is located in a VTAM subarea, you can define a link to 
the VITAM subarea, and the VTAM subarea can locate the partner node for 
you. 


To define a link, you must define these parameters: 
— Network Name 


This is the Network Name of the partner machine. To determine this 
value, refer to the “How to find...” section of the partner machine’s config- 
uration chapter. 


— Partner LU Name 


This is the LU name of the partner machine. To find this value, refer to 
the “How to find...” section of the partner machine’s configuration chapter. 


— Adjacent LAN Address 


This is the address of the adjacent node or the network node you are con- 
necting to. In a token ring, this is the address of the token ring card at the 
adjacent node. To find this value, refer to the “How to find...” section of 
the partner machine’s configuration chapter. 


Define partner LU name 


If you ARE NOT using a network node in your network, you must define a 
partner LU name. This will allow the partner to be located. 


— Partner LU Name 


This is the Local LU name defined on the partner machine. To find this 
value, refer to the “How to find...” section of the target machine’s configura- 
tion chapter. . 


If you ARE using a network node in your network, you do not need to define 
an explicit partner LU name. However, you will need to know the partner LU 
name when running transaction programs. 


CPI-C Side Information may be used to associate a set of parameters, including 
the partner LU name, with a symbolic destination name. The symbolic destina- 
tion name can then be used when running transaction programs to specify the 
partner. Each platform has directions for configuring CPI-C side information. 


¢ Configure to run as a server 


How do I Configure a Network? 


If you are configuring your computer to run as a server, a transaction program 
must be configured on your computer. The transaction program will be the 
target of a conversation started by a client. 


— TP name 


1 to 64 alpha-numeric characters. This is the name specified by the partner 
APPC application when it wants to start a conversation with a TP on your 
computer. 
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2.0 AIX SNA Services/6000 Configuration 


This chapter explains how to configure AIX SNA Services/6000. AIX SNA 
Services/6000 is IBM’s implementation of APPC for AIX. Version 1.2 supports 
only low entry networking nodes (see 1.9, “What Is APPN?” on page 6 for a dis- 
cussion of SNA node types). The machine to be configured should have AIX 
version 3.2 and SNA Services version 1.2 with the latest updates applied. This 1s 
necessary to get the maximum benefit of APPC, including CPI-C support, and 
mode definitions. To check the level of SNA Services you have installed, run the 
command 


Islpp -h sna.sna.obj 
The result should contain four numbers similar to this: 
01.02.0000.0000 


If the last number is “0000”, you do not have the latest updates. You should apply 
PTF’s U411903 and U411904. If the last number is “0224” (indicating the July, 
1992 quality refresh) or “0244” (indicating the December, 1992 quality refresh), then 
your SNA Services are sufficiently updated. 


This document describes all of the profiles that need to be created to configure an 
AIX machine to run APING to another machine. A few profiles may be left out if 
you don’t plan to run this AIX machine as a server. These will be noted. 


2.1.1 Prerequisites 
e AIX V3.2 


¢ AIX SNA Services/6000 V1.2 with PTF’s U411903 and U411904 


¢ Token-nng adapter 


For more detailed configuration information, refer to the following publications: 
¢ Using AIX SNA Services/6000, SC31-7002 
¢ AIX SNA Services/6000 Reference, SC31-7014 


2.2 Terminology 


The terminology table maps the standard networking terms defined in 1.10, “How 
do I Configure a Network?” on page 7 to the terms used“by SNA Services/6000: 


Panne LU Nam 
Adjacent LAN Address 
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2.3 SNA Services/6000 Configuration Worksheet 


Use the following worksheet to determine all the values you will need to configure 
this platform. The worksheet is split into two parts: values determined by referring 
to the Guide introduction or other platform chapters, and values that are local to 
this platform which you create. There are three columns. The left-most column 
has a variable name that starts and ends with a question mark (?), the middle 
column describes what the vanable is used for and how to determine its value, and 
the nght-most column is left blank so you can fill in a value. Whenever there is a 
reference in this chapter to a value in the left column, substitute the value you have 
written in the nght column. 


For example, if you are following the recommendations in the Worksheet, you will 
write #/NTER in the nght column on the ?7MODE? line. Then in Figure 13 on 
page 24 you will type #INTER in the “MODE name?” field to replace “7MODE” 
like this: 


CPI Communications Side Information 


PROFILE name = 2SYMDEST? 
PARTNER LU name = ?CALLCONNPRO? 
REMOTE TRANSACTION PROGRAM name = ?TPNAHME? 
SERVICE transaction program? = no 

MODE name = #INTER 


Figure 2. CP! Communications Side Information 


Notes: 


In the following chart and throughout this chapter, be aware that all of the 
values entered are case-sensitive. So if you enter a particular value in lower case 
in one place, remember to enter the same value in lower case when it appears 
again. 


Values that must match with other places 


Symbol How to determine the value for this symbol | Fill in value 
7 here 


?7LOCALLU? 


?LOCALCP? 


This is the symbol that refers to the LU name of the 
machine you are defining to the network. It 1s a | to 8 char- 
acter field consisting of upper-case alphanumeric characters 
which represent the LU name of the node. Choose a name 
that is unique within the same network. Refer to 1.10, 
‘‘“How do I Configure a Network?” on page 7 for informa- 
tion about LU names. 


This is the symbol that refers to the Control Point name of 
your machine. It is same as your 7LOCALLU?. Refer to 
1.9, “What Is APPN?” on page 6 for more information 
about control points. 
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Symbol How to determine the value for this symbol Fill in value 
here 


?LOCALNET? This is the symbol that refers to the network name of the 
machine you are defining to the network. While it can be 
any | to 8 character field consisting of upper-case alphanu- 
meric characters, there is a structured format that can be fol- 
lowed to insures uniqueness of the network name around the 
world. Call your local [BM branch office for the format 
information and to register your network name. Refer to 
1.10, “How do I Configure a Network?” on page 7 for more 
information about network names. 


?PARTNERLU? 


This is the partner’s LU name. Refer to the “How to find...” 
section of the partner computer’s configuration chapter for 
this value. For AIX SNA Services/6000, this value is to be 
entered in upper case. Refer to 1.10, “How do I Configure a 
Network?” on page 7 for more information about the 
partner LU name. 


2?PARTNERNET? This 1s the symbol for the network name of the partner com- 
puter. Use the network name from the partner computer's 
“How to find...” section. For AIX SNA Services/6000, this 
value 1s to be entered in upper case. Refer to 1.10, “How do 
I Configure a Network?” on page 7 for more information 


about the partner network name. 


7LANADDRESS? This is the symbol for the LAN Address of the partner com- 
puter. (Or the LAN Address of a network node, if the link is 
being made to a network node.) For AIX SNA 
Services/6000, this letters in this value are to be entered in 
upper case. Refer to the “How to find...” section of the 


partner computer’s configuration chapter for this value. 


?TPNAME? This is the symbol for the Transaction Program name. This 
is the name of the transaction program at the partner com- 
puter. It is 1-64 bytes long, and it 1s case sensitive. For 


APING, the TP Name on the server is APINGD. 


7TPPATH? This is the symbol for the fully specified path and filename 
of the executable code for a server transaction program 
located on your machine. For APINGD, this may be: 


[local/sna/apingd. 


?MODE? This is the symbol for the mode name. See 1.6, “What Is a 
Mode?” on page 5 for a discussion of modes. Often, a 
client/server product’s documentation specifies what mode 
must be used by that product. APING can use any mode 
(this can be specified on the APING command line), but the 
default is #INTER. It is recommended that you use one of 
the architected modes discussed in the “What Is a Mode?” 
section. For AIX SNA Services/6000, this value must be 


entered in upper case. 


Local values 
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Symbol | How to determine the value for this symbol Fill in value 
| here 


2S YMDEST? This is the symbol for the CPI-C side information symbolic — | 

destination name. It is any 1-8 character name you choose. 

| It will be used locally on the AIX machine to refer to a 
CPI-C side information entry. See 1.7, “What Is CPI-C side 
information?” on page 5 for more information on CPI-C 
Side Information. | | 
Note: The December 1992 quality refresh of SNA 
Services/6000 fixes an error that would require you to specify 
a symbolic destination that is exactly eight characters long 
when running APING. If you only have the July 1992 
quality refresh (see 2.0, “AIX SNA Services/6000 , 
Configuration” on page 11), you should specify an eight 
character symbolic destination name. 


The following are the names of the profiles that must be configured. The profile names must be | to 14 
characters long (unless otherwise indicated). The profile names are referenced only on the machine you 
are configuring, and do not need to match any values on other machines. Some suggestions for profile 
names are provided. | 


If you are using Quick Configuration, you only need to fill in a value for the first symbol below 
(?QUICKPRO?). All the profile names generated for the Quick Configuration will be the same (except 
the Transaction Program and Mode profile names which are slightly modified). 


°?QUICK PRO? 


The symbol for name that Quick Configuration uses to gen- 
erate profile names for all the profiles it creates. You don’t 
need this value if you are not using Quick Configuration. 
This value is 1-12 characters long. Suggestion: use the same 
value as that used for the 7PARTNERLU? symbol. 


?CPPRO? The symbol for the name of the Control Point profile. Sug- 
gested profile name: CPPRO 
?LUPRO? The symbol for the name of the Local Logical Unit 6.2 
profile. Suggested profile name: LUPRO 
?CALLATTACHPRO? | The symbol for the name of the Outgoing (CALL) Attach- 
ment profile. Suggested profile name: CALLATT 


Note: The attachment profile names are only 1-8 characters 
long. 


The symbol for the name of the Incoming (LISTEN) 
Attachment profile. Suggested profile name: LISTATT 


?7LISTATTACHPRO? 


Note: The attachment profile names are only 1-8 characters 
long. | 


27CALLCONNPRO? The symbol for the name of the Outgoing (CALL) Con- 
nection profile. Suggested profile name: CALLCONN - 
?LISTCONNPRO? The symbol for the name of the Incoming (LISTEN) Con- 


nection profile. Suggested profile name: LISTCONN 


140 0 Nutti-Platform Canfie 


How to determine the value for this symbol 


Symbol | 


27MODEPRO? 


The symbol for the name of the Mode Profile. To avoid 
defining new modes, use one of the mode profiles already 
supplied by SNA Services/6000: 


° INTER 

¢ BATCH 

¢ INTERSC 
¢ BATCHSC 


Note that these are the mode profile names. The actual 
modes defined by them are: #INTER, #BATCH, 
#INTERSC, and #BATCHSC. Which one to choose may 
depend on the requirements of your client/server application, 
as specified in its documentation. See 1.6, “What Is a 
Mode?” on page 5 for a discussion of these modes. To use 
the default mode that APING uses, specify INTER. 


?MODELISTPRO? The symbol for the name of the Mode List profile. Sug- 
gested profile name: )IODELIST 


2RTPNAMEPRO? The symbol for the name of the Remote Transaction 

Program Name profile. This value must not be the same as 
any local Transaction Program Name profiles (Denoted by 
7TPNAMEPRO? below.). Suggested profile name: use the 
7TPNAME? value, followed by an “R”. (For APING, this 
would be APINGDR.) If this machine is being configured 


Fill in value 
here 
as a server only, you do not need to create any Remote 


Transaction Program Name profiles. 


27RTPLISTPRO? The symbol for the name of the Remote Transaction 
Program List profile. Suggested profule name: RTPLIST If 
this machine 1s being configured just as a server (i.e. it will 
not try to start transaction programs on the partner 
machine), you do not need to create a Remote Transaction 
Program List profile and can use the default profile provided 


by SNA Services/6000 called RDEFAULT. 


JT PNAMEPRO? The symbol for the name of the local Transaction Program 
Name profile. Suggested profile name: If the value for 
7TPNAME? is less than 12 characters long, use the value for 
7TPNAME? followed by “PRO”. For example: 
APINGDPRO. Otherwise, make up a profile name that is- 
1-14 characters long. If you will not be running this 
machine as a server, you do not need to configure any local 


Transaction Program Names, and wil therefore not need 
this value. | 


sa 
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How to determine the value for this symbol Fill in value 
here 


The symbol for the name of the Transaction Program List 
profile. Suggested profile name: TPNLIST. If you will not 
be running this machine as a server, you do not need to con- 
figure transaction programs on it. In this case, use the 
default Transaction Program List profile name, | 
TDEFAULT. Again, if you will not be running this 
machine as a server, you do not need to configure a local 
Transaction Program List profile, and will therefore not need 
this value. 


Symbol 


7TPNLISTPRO? 


2.4 Working with APPC configuration 


The following configuration steps will be discussed: 
1. Define yourself to the network 
2. Define a link to a partner or intermediate node 
a. Additional LEN configuration 
b. Other link configuration 
3. Configure to run as a client 
a. Define CPI-C side information 
b. Other client configuration 
4. Configure to run as a server 
a. Define transaction programs 
b. Other server configuration | 
SNA Services stores its configuration information within encoded profiles that are 
accessed using the System Management Interface Tool (SMIT). SMIT presents 
panels on which you enter your configuration values. All of the values used in AIX 


SNA Services/6000 are case-sensitive, so be sure to always enter profile names and 
other configuration values in the same case throughout the SMIT panels. 

Within SMIT, SNA Services configuration panels can be accessed by selecting the | 
following series of panels: : 


--Communications Applications 
--SNA Services 
--Configure 
--Advanced Configuration 


For the rest of this discussion, other panels will be specified from this base level 
within SMIT. 


The user should have the base configuration of AIX SNA Services installed and 
have “system group” access to the system in order to run SMIT and start the SNA 
subsystem. “System group” authority is required to make the changes suggested in 
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this document. See the document, Using AIX SNA Services/6000, SC31-7002, for 
more information on SNA Services installation. 


For this discussion, we will progress through a basic configuration that allows both 
an outgoing and incoming APING operation to be performed. This chapter 
describes how to configure a workstation that is attached to a Token Ring LAN and 
assumes the token nng DLC has been created by the system. Other DLC’s will 
require Attachment Profile definitions that would replace the Token Ring Attach- 
ment Profile described below. 
There are several profiles that need to be defined: 

1. A Control Point Profile 
. A Local LU (6.2) Profile 
. 2 Token Ring Attachment Profiles 
. Two Logical Connections Profiles 
. A Mode List Profile 
. A Remote TP Name Profile 
. A Remote TP Name List Profile 
. A CPI-C Side Information Entry 
. A TP Name Profile 
. A TP Name List Profile 
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2.4.1 Quick Configuration 
AIX SNA Services/6000, with the PTFs specified in 2.0, “AIX SNA Services/6000 
Configuration” on page 11, provides a “Quick Configuration” utility that creates all 
of the above profiles based on information entered on just one or two SMIT panels. 
This Quick Configuration is an excellent way to configure a simple connection to a 
partner machine using a single mode definition and a single transaction program 
definition. Quick Configuration is designed for just such a scenario. Quick Config- 
uration does not reuse profiles that have already been defined. So, if you repeatedly 
use Quick Configuration to define connections to partners, then multiple LU pro- 
files, mode profiles, mode list profiles, etc. will be defined. It 1s recommended that if 
you choose to use Quick Configuration that you use it to define the first connection 
to a partner, but from then on to follow the explicit instructions for adding or 
updating the other profiles. 


2.4.2 Verifying configuration 
Once the profiles are created, they can be verified using either the command 
verifysna, or in SMIT by following this hierarchy of panels: 


--Communications Applications and Services 
--SNA Services 
--Configure SNA Profiles 
--Advanced SNA Configuration 
--Verify SNA Configuration Profiles 
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2.4.3 Starting and stopping APPC 


APPC is part of the AIX SNA Services/6000 subsystem. You can use the following 
command to test the status of the SNA subsystem: 


Issrc -l -S Sna 


If the SNA subsystem is not started, it can be started with the command: 


startsrc -sS sna 


_ 


If you want the partner computer to be able to initiate a conversation to this AIX 
machine, you need to start the listen attachment before your partner attempts to 
activate the link between the two. Do this with this command: 


sStartsrc -t attachment -o ?LISTATTACHPRO? 

Note: The “?LISTATTACHPRO” value must match the “PROFILE name” of 
the Token Ring Attachment profile defined as the incoming, or “listen” attachment. 
To stop the SNA subsystem, execute this command: 


stopsrce -s sna 


2.5 Configuration 


2.5.1 Starting from Scratch 


If you would like to set your SNA configuration to its default values, run this 
command: 
/usr/|pp/sna/bin/peu 


To run this command, you need “root” authority, and you should delete or move all 
the files in /etc/opjrepos/sna. 


2.5.2 Quick Configuration 


TR 


1. From within SMIT, follow these panels: 


-- Communications Applications and Services 
--SNA Services 
--Configure SNA Profiles 
--Quickly Configure an LU 6.2 Connection 


2. Enter a 1-12 character name (This is the value you filled in for the 
2?QUICKPRO? symbol in the Worksheet). All profiles created during this quick 
configuration will contain this name. 


3. Specify “no” when asked if you wish to configure to an existing network attach- 
ment. | 


4. Select a default network ATTACHMENT type: token_ring_listen if your 
partner will initiate the conversation, token_ring_call if you will be initiating the 
conversation. To allow both actions, you will need to add another attachment 
profile after Quick Configuration, or follow the non-Quick Configuration 
instructions below. | 


The following figure shows the Quick Configuration panel. Replace the 
symbols (the words beginning and ending with question marks) with the corre- 
sponding values from the Configuration Worksheet. You'll also need to change 
any other values that are highlighted. 
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Quick Configuration NAHE 
Fully qualified LOCAL LU name 
Local LU ADDRESS 

HODE name 


2QUICKPRO? 

?LOCALHET?. 2LOCALLU? 

) 

2HODE? 

2TPPATH? 
?PARTHERNET ?. 2PARTHERLU? 
2TPHAHE 2 

?QUICKATTACH? #see note a 
?LANADDRESS? #see note b 


Local Transaction Program name 
Fully qualified REMOTE LU name 
Remote Transaction Program name 
ATTACHMENT 

Link ADDRESS 


Figure 3. Quick Configuration panel. 


Notes: 
a. The value in this field is already fixed when this panel is displayed. 
b. This field only appears if this configuration is based on a Call attachment. 


5. You should now have a connection to a partner properly configured. Skip to 
2.6, “Running APING” on page 26. The following descriptions for adding pro- 
files can be used to understand the profiles that were created by Quick Config- 
uration, and to expand the configuration (by adding transaction program 
profiles, mode profiles, and more connection profiles that reference the profiles 
already created by Quick Configuration). 


2.5.3 Define yourself to the network 


2.5.3.1 Create Control Point profile 
A control point must be defined to run APPC on SNA Services. This definition is 
done by adding a Control Point profile. 


From within SMIT, the Control Point profile can be accessed by following this 
series of panels: 


--Nodes 
--Control Point 


The following figure shows the Control Point profile panel. Replace the symbols 
(the words beginning and ending with question marks) with the eeneseerene 
values from the Configuration Worksheet. 


PROFILE name 
XID node. ID 


2CPPRO? 

00000000 # see note 
?LOCALNET? 

7LOCALCP? 


HETWORK name 
CONTROL POINT name 


oo ow nm on 


Figure 4. Control Point profile 
Note: It is not recommended that you use an XID node ID for configuration. See 


Appendix A, “Using Node IDs in VTAM” on page 143 for a discussion of whether 
you should, and if so, what value to use here. 
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2.5.3.2 Create a local LU 6.2 Profile | 
The local LU 6.2 profile must also be added. Its definition follows. 


From within SMIT, this can be accessed via: 


--Logical Units 
--LU6.2 
--LU6.2 Local Logical Unit 


The following figure shows the Control Point profile panel. Replace the symbols 
(the words beginning and ending with question marks) with the corresponding 
values from the Configuration Worksheet. 


?LUPRO? 
2TPHLISTPRO? 
?LOCALNET? 
?LOCALLU? 
yes 

1 


x 


PROFILE name 
TPN LIST profile name 
NETWORK name 


Local LU NAME 
INDEPENDENT LU? 
Local LU ADDRESS 
SSCP ID 


Figure 5. Local LU6.2 profile 


2.5.4 Define a link to a partner or network node 
Next, the partner LU and link need to be defined in order for a connection to the 
partner LU to be established. There are two types of links that can be defined. 
One type of link allows this machine to initiate a connection to the partner com- | 
puter. This link is called a “call” attachment. The other allows the partner com- 
puter to initiate a connection with the local computer. This link 1s called a “listen” 
attachment. Both attachments must be defined if both partner and local computers 
wish to be able to initiate a connection. The listen attachment must be started 
before the partner attempts to activate the link. Instruction on starting the link 1s 
discussed in 2.4.3, “Starting and stopping APPC”’ on page 18. 


2.5.4.1 Create a Token Ring Attachment profile (LISTEN or incoming) 
From within SMIT, the Token Ring Attachment profile can be accessed by fol- 
lowing this series of panels: 


--Physical Units 
--Token Ring 
--Token Ring Attachment 


The following figure shows the Listen (incoming) Attachment profile panel. 
Replace the symbols (the words beginning and ending with question marks) with 
the corresponding values from the Configuration Worksheet. You'll also need to 
change any other values that are highlighted. 
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PROFILE name 

CONTROL POINT profile name 
LOGICAL LINK profile name 
PHYSICAL LINK profile name 
STOP ATTACHHENT on inactivity? 
inactivity TIMEOUT 

LU address REGISTRATION 
REGISTRATION PROFILE name 
CALL type 

AUTO-LISTEN? 

MINIMUM SAP address 
MAXIMUM SAP address 

ACCESS ROUTING 

REMOTE LINK name 

Remote LINK address 

Remote SAP address 


2LISTATTACHPRO? 
2CPPRO? 
TDEFAULT 
TDEFAULT 

no 

0 

no 

LDEFAULT 

listen 


link _name 


000000000000 
04 


Figure 6. Token Ring Attachment Profile (LISTEN or incoming) 


2.5.4.2 Create a Token Ring Attachment profile (CALL or outgoing) 
The following figure shows the call (outgoing) Attachment profile panel. Replace 
the symbols (the words beginning and ending with question marks) with the corte- 
sponding values from the Configuration Worksheet. You'll also need to change any 


other values that are highlighted. 


Token Ring Attachment profile (CALL) 
PROFILE name 
CONTROL POINT profile name 
LOGICAL LINK profile name 
PHYSICAL LINK profile name 
STOP ATTACHHENT on inactivity? 
inactivity TIMEOUT 
LU address REGISTRATION 
REGISTRATION PROFILE name 
CALL type 
AUTO-LISTEN? 
MINIHUH SAP address 
MAXIMUM SAP address 
ACCESS ROUTING 
REHOTE LINK name 
Remote LINK address 
Remote SAP address 


u uo ut 1) "i u bow ” u u u ui “uo 


2CALLATTACHPRO? 
2CPPRO? 
TDEFAULT 
TDEFAULT 

no 

0 

no 

LDEFAULT 


link_address 


2LANADDRESS? 
04 


Figure 7. Token Ring Attachment profile (CALL or outgoing) 


2.5.4.3 Define Logical Connections 


The connection profile specifies the attachment profile to be used to activate the 
partner, the partner LU name, and the Remote Transaction Program (RTP) name 
list. Again, in order to act as both client and server, separate connection profiles. 


must be defined. 


From within SMIT, the Logical Connection profiles can be accessed by following 


this series of panels: 


--Logical Units 
--LU6.2 
--LU6.2 Logical Connection 
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Create Logical Connection profile (CALL): The following figure shows the CALL 
Logical Connection profile panel. Replace the symbols (the words beginning and 
ending with question marks) with the corresponding values from the Configuration 
Worksheet. You'll also need to change any other values that are highlighted. 


2CALLCOHNPRO? 
2CALLATTACHPRO? 
2LUPRO? 
2PARTNERHET? 

no 

0 

2?PARTHERLU? 
conversation 
rofile = CONVDEFAULT 
2RTPLISTPRO? 
2HODELIST PRO? 
extended 
parallel 

no 


PROFILE name 

ATTACHHENT profile name 

LOCAL LU profile name 

NETWORK name 

STOP CONNECTION on inactivity? 
TIMEOUT 

REMOTE LU name 


SECURITY Accepted 

CONVERSATION SECURITY ACCESS LIST 
REMOTE TPN LIST profile name 

MODE LIST profile name 

INTERFACE type 

SESSION CONCURRENCY 

Node VERIFICATION? 


uoeuw & vw fo tb vu # t un tt om on 


Figure 8. Logical Connection profile (CALL) 


2.5.4.4 Create Logical Connection profile (LISTEN) 
The following figure shows the LISTEN Logical Connection profile panel. Replace 
the symbols (the words beginning and ending with question marks) with the corre- 
sponding values from the Configuration Worksheet. You'll also need to change any 
other values that are highlighted. 


2LISTCONNPRO? 
2LISTATTACHPRO? 
?LUPRO? 

2 PARTHERNET ? 

no 

0 

2PARTHERLU? 
conversation 
rofile = CONVDEFAULT 
2RTPLISTPRO? | 
2MODELISTPRO? 
extended 

parallel 

no 


PROFILE name 

ATTACHMENT profile name 

LOCAL LU profile name 

NETWORK name 

STOP CONNECTION on inactivity? 
TIMEOUT 

REMOTE LU name 


SECURITY Accepted 

CONVERSATION SECURITY ACCESS LIST 
REMOTE TPN LIST profile name 

MODE LIST profile name 

INTERFACE type 

SESSTON CONCURRENCY 

Node VERIFICATION? 


new & bone tf # hf tt uw nm ot ou 


Figure 9. Logical Connection profile (LISTEN) 


2.5.5 Configure to run as a client 
To run as a client, the following information needs to be configured: 


¢ the modes to be used (unless using the predefined modes already provided with 
the product), and | 


¢ the names of the Transaction Programs to run on the target machines, and 


¢ optionally, CPI-C Side Information. 
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2.5.5.1 Define the Mode List 
The mode list contains the names of the mode profiles that can be used by a trans- 
action program. 


From within SMIT, the mode profile list can be accessed by following this series of 
panels: 


--Logical Units 
--LU6.2 
--LU6.2 Mode List 


The following figure shows the Mode List profile panel. Replace the symbols (the 
words beginning and ending with question marks) with the corresponding values 
from the Configuration Worksheet. You can add more than one profile to this list. 


Hode List 


2MODELISTPRO? 
2HODEPRO? 
2MODEPRO2? 
2HODEPRO3? 


PROFILE name 
Name 1 
Name 2 
Name 3 


Figure 10. Mode List 


2.5.5.2 Create the Remote TP Name profile 
The remote TP profile specifies a Transaction Program that will be run on the 
partner machine. A Remote TP Name list is then created to collect a set of Remote 
TP Name profiles. Neither the Remote TP Name profiles nor the Remote TP 
Name list need to be created if this machine will only be running as a server. 


From within SMIT, the Remote TP Name profile can be accessed by following this 
series of panels: 


--Logical Units 
--LU6.2 
--LU6.2 Remote Transaction Program Name 


The following figure shows the LISTEN Logical Connection profile panel. Replace 

the symbols (the words beginning and ending with question marks) with the corre- 

sponding values from the Configuration Worksheet. You'll also need to change any 
_ other values that are highlighted. 


Remote TP Name profile 
PROFILE name 
RTPH name is in HEXADECIMAL? 
RTPN name | 


2RT PHAHE PRO? 
no 

?T PHAME 2 

no 

mapped 
no_reconnect 
confirm 


PIP data? 
CONVERSATION type 
RECOVERY level 
SYNC level 


Figure 11. Remote Transaction Program Name 
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2.5.5.3 Create Remote TP Name List profile 


From within SMIT, the Remote TP Name List profile can be accessed i following 
this series of panels: 


--Logical Units 
--LU6.2 . 
--LU6.2 Remote Transaction Program Name List 


The following figure shows the Remote TP Name List profile panel. Replace the 
symbols (the words beginning and ending with question marks) with the corre- 
sponding values from the Configuration Worksheet. | 


Figure 12. Remote Transaction Program Name List profile 


Note: More remote transaction programs can be configured by creating more 
Remote Transaction Name profiles and adding them to this list. 


2.9.9.4 Defining CPI-C Side Information 


VA 


Some applications, ike APING, do not require CPI-C side information. These 
applications use programming calls available on a particular platform to dynamically 
create side information when running. SNA Services/6000 provides the program- 
ming calls that allow APING (and other applications) to do this dynamic definition, 
so you do not need to create this Side Information profile for APING. For those 
applications that require CPI-C Side Information, this is how to create a profile: 


From within SMIT, CPI-C Side Information panel can be accessed by following 
this series of panels: | 


--Logical Units 
--LU6.2 
--LU6.2 CPI Communications Side Information 


The following figure shows the CPIC-C Side Information panel. Replace the 
symbols (the words beginning and ending with question marks) with the corre- 
sponding values from the Configuration Worksheet. 


CPI Communications Side Information 
PROFILE name 
PARTNER LU name 


2SYMDEST? 
2CALLCONNPRO? 
2T PHAME 2 

no 

2MODE? 


REMOTE TRANSACTION PROGRAH name 
SERVICE transaction program? 
MODE name 


1) | | | 


Figure 13. CP! Communications Side Information 
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2.5.6 Configure to run as a server 


2.5.6.1 Define local transaction programs 
To run AIX as a server, you must define the transaction programs (TPs) on your 
machine with which a client can start a conversation. For each TP, you must 
define a TP profile, and then you need to create a TP Name List profile that lists 
the TP profiles you have defined. This TP Name List profile will then be refer- 
enced in the definition of a connection. (If you will not be running this machine as 
a server, you do not need to create either the Transaction Program Name profile or 
the Transaction Program Name List profile.) 


2.5.6.2 Create Transaction Program Name 


From within SMIT, the Transaction Program Name profile panel can be accessed 


by following this senes of panels: 


--Logical Units 
--LU6.2 
--LU6.2 Transaction Program Name 


The following figure shows the Transaction Program Name profile panel. Replace 
the symbols (the words beginning and ending with question marks) with the corre- 
sponding values from the Configuration Worksheet. You'll also need to change any 


other values that are highlighted. 


PROFILE name = 


Transaction program name is in HEXADECIMAL? = 


TRANSACTION program name 

PIP data? 

SUBFIELDS 

CONVERSATION type 

RECOVERY level 

SYNC level 

Full PATH to TPN executable 
MULTIPLE INSTANCES supported? 
User ID 

SERVER synonym name 

RESTART action 

COMMUNICATION type 

IPC queue key 

Standard INPUT file/device 
Standard OUTPUT file/device 
Standard ERROR file/device 
SECURITY Required 
communication_ipc_queue_key 
RESOURCE SECURITY ACCESS LIST 


Figure 14. TP Name profile 


2.9.6.3 Create Transaction Program Name List 


profile = 


2T PNAMEPRO? 
no 
2T PHAME? 

no 

0 

mapped 
no_reconnect 
confirm 
2TPPATH? 

yes 

100 

TDEFAULT 
once 

Signals 

0 

/dev/nul} 
/dev/console 
/dev/console 
none 

0 
RSRCDEFAULT 


From within SMIT, the TP Name List profile panel can be accessed by following 


this series of panels: 


--Logical Units 
--LU6.2 


--LU6.2 Transaction Program Name List 


The following figure shows the LISTEN Logical Connection profile panel. Replace 
the symbols (the words beginning and ending with question marks) with the corre- 
sponding values from the Configuration Worksheet. 
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TP Name List 


PROFILE name = ?TPNLISTPRO? 
Name 1 ?TPNAHE PRO? 


Figure 15. Transaction Program Name List 


Note: You can define more Transaction Programs to be run between two machines 
by adding more TP Name profiles and adding them to this TP Name List. 


2.6 Running APING 


Execute APING to contact the partner LU defined by the outgoing connection, 


2CALLCONNPRO?, by typing: 
aping -n ?CALLCONNPRO? 


with the APING executable being located in a directory in the system’s PATH (ex. 
/local/appctps). If you ran Quick Configuration to generate your profiles, the value 
to use for ?CALLCONNPRO? is the same value used to name your quick config- 


uration, 7?QUICKPRO?. 


You can alternatively specify the CPI-C symbolic destination name: 


aping -n ?SYMDEST? 


~_ 


Once an incoming session is established, the RS/6000 can communicate with this 
caller only on this session (and not on a new outgoing call). This problem will be 
fixed in a later release. Thus, if an incoming session is already established, you 
would not specify ?7CALLCONNPRO? as the barge You would specify the listen 
connection, 7LISTCONNPRO?. 


2./ How to find... 


VA 


« LU name 


The LU name is specified in a Local LU6.2 profile as the “Local LU NAME” 
parameter. To find out which Local LU6.2 profile to look at, see the listen 
Logical Connection profile parameter “LOCAL LU profile name”. There may 
be many Logical Connection profiles. The one to use is the one that specifies 
as its “ATTACHMENT profile name” the same Token nng Attachment profile 
used in the startsrc command that starts the listen attachment. 


For example: In the configuration recommended above, the Token Ring 
Attachment profile specified in the startsre command is LISTEN. The Logical 
Connection profile that specifies LISTEN as its “ATTACHMENT profile 
name” is called 7>CALLCONNPRO?. The “LOCAL LU profile name” in the 
?CALLCONNPRO? Logical Connection profile 1s 7 L.UPRO? Therefore, the 
LU name 1s the value specified as the “Local LU NAME” parameter of the 
?LUPRO? Local LU6.2 profile. 


« Network name 


See the discussion for how to find the local LU name. The Network name is 
also specified in the Local LU6.2 profile, as the “NETWORK name” parameter. 


¢ Control Point (CP) name 
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The CP name is specified in the Control Point profile as the “CONTROL 
POINT name.” The actual Control Point profile being used is specified in the 
Attachment profiles as the “CONTROL POINT profile name.” 


LAN address 


The LAN address is hard-coded on the Token-Ring adapter in the AIX 
machine or is over-ridden by a value called the “locally administered LAN 
address. It 1s a 12-digit hexadecimal value. You can find the LAN address by 
running the command Iscfg -v. The LAN address is specified by the Network 
Address parameter under the tok0 resource. This parameter will specify the 
locally administered address if there 1s one. 
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3.0 AIX SNA Server/6000 Configuration 


This chapter explains how to configure AIX SNA Server/6000. AIX SNA 
Server/6000 is IBM’s implementation of APPN for AIX. Version 2.1 supports 
APPN network nodes, end nodes, and low entry networking nodes (see 1.9, “What 
Is APPN?” on page 6 for a discussion of SNA node types). The machine to be 
configured must have AIX version 3.2 and SNA Server version 2.1 installed. To 
check the level of SNA Server you have installed, use the command 


Islpp -h sna.sna.obj 
The result should contain four numbers similar to this: 
01.03.0000.0000 


The first 0000 contains a number identifying the year in which this level was made 
available (0093 is equivalent to 1993). The last 0000 represents the week of the year 
(0115 is equivalent to the 11th week, Sth build of that week). 


This document describes all of the profiles that need to be created to configure an 
AIX machine to run APING to another machine. You may leave a few profiles 
out uf you don’t plan to run this AIX machine as a server. These will be noted. 


3.1.1 Prerequisites 
¢ AIX V3.2 


¢ AIX SNA Server/6000 V2.1 


¢ Token-ring adapter 


~ 


For more detailed configuration information, refer to the following publications: 
© AIX SNA Server/6000: User's Guide, SC31-7002-01 
¢ AIX SNA Server/6000: Configuration Reference, SC31-7014-01 


3.2 Terminology 


The terminology table maps the standard networking terms defined in 1.10, “How 
do I Configure a Network?” on page 7 to the terms used by SNA Server/6000. 


AIX SNA Server[6000 Term 


Par LU Nae 
LAN Address Link Address 
Remote link address 
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3.3 SNA Server/6000 Configuration Worksheet 


Use the following worksheet to determine all the values you will need to configure 
this platform. The worksheet 1s split into two parts: values determined by referring 
to the Guide introduction or other platform chapters, and values that are local to 
this platform which you create. There are three columns. The left-most column 
has a variable name that starts and ends with a question mark (?), the middle . 
column describes what the variable is used for and how to determine its value, and 
the nght-most column is left blank so you can fill in a value. Whenever there 1s a 
reference in this chapter to a value in the left column, substitute the value you have 
written in the right column. 


For example, if you are following the recommendations in the Worksheet, you will 
write #/NTER in the nght column on the MODE? line. Then in Figure 19 on 
page 36 you will type ZINTER in the “MODE name” field to replace “7 MODE” 
like this: 


Profile name = “2SYMDEST2" 
Local LU or Control Point alias =n 
Partner LU alias = uu 


Fully qualified partner LU name = "?PARTNERNET?. ?PARTNERLU? “ 
Hode name | . = “?M00E2" 

Remote transaction program name (RTPN) = "?TPNAME?" 

RTPN in hexadecimal = no 

Comments =u" 


Figure 16. CPI Communications Side Information 


Notes: 


In the following chart and throughout this chapter, all of the values entered are 
case-sensitive. So if you enter a particular value in lower case in one place, 
remember to enter the same value in lower case when it appears again. 


Symbol How to determine the value for this symbol Fill in value 
| here 


Values that must match with other places 


?7LOCALLU? 


This is the symbol that refers to a LU name in the machine 
you are defining to the network. It is a 1 to 8 character field 
consisting of upper-case alphanumeric characters which rep- 
resent an LU name in the node. Choose a name that is 
unique within the same network. Refer to 1.10, “How do I 
Configure a Network?” on page 7 for information about LU 
names. A local LU name 1s not necessary for communicating 
with other nodes in the network. The local CP name may | 
function as the default LU name, in which case you do not 
need a local LU name defined. 
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Symbol How to determine the value for this symbol Fill in value 
here 


?7LOCALCP? This is the symbol that refers to the Control Point (CP) 


name of your machine. It must be unique in the network. 
?7LOCALNET? 


The local CP name may be used as the local LU for estab- 
lishing sessions with remote stations. If sessions with local 
LUs besides the local CP is desired, then a local LU name 
must be defined. Refer to 1.9, “What Is APPN?” on page 6 
for more information about control points. 


This is the symbol that refers to the network name of the 
machine you are defining to the network. While it can be 
any | to 8 character field consisting of upper-case alphanu- 
meric characters, there is a structured format that can be fol- 
lowed to insures uniqueness of the network name around the 
world. Call your local IBM branch office for the format 
information and to register your network name. Refer to 
1.10, “How do I Configure a Network?” on page 7 for more 
information about network names. | 


27PARTNERLU? This is the symbol for the partner’s LU name. Refer to the 
“How to find...” section of the partner computer’s configura- 
tion chapter for this value. Refer to 1.10, “How do I Con- 
figure a Network?” on page 7 for more information about 


the partner LU name. 


?7PARTNERNET? This is the symbol for the network name of the partner com- 
puter. Use the network name from the partner computer’s 
“How to find...” section. Refer to 1.10, “How do I Con- 
figure a Network?” on page 7 for more information about 


the partner network name. 


27LANADDRESS? This is the symbol for the LAN Address of the partner com- 
puter. (Or the LAN Address of a network node, if the link is 
being made to a network node.) Refer to the “How to 
find...” section of the partner computer's configuration 


chapter for this value. 


7TPNAME? This is the symbol for the Transaction Program name. This 
is the name of the transaction program at the partner com- 
puter. It is 1-64 bytes long, and it is case sensitive. For 


APING, the TP Name on the server is APINGD. 


7TPPATH? This is the symbol for the fully specified path and filename 
of the executable code for a server transaction program 
located on your machine. For APINGD, this may be: 


[ocal/sna/apingd. 


2MODE? This is the symbol for the mode name. See 1.6, “What Is a 
Mode?” on page 5 for a discussion of modes. Often, a 
client/server product’s documentation specifies what mode 
must be used by that product. APING can use any mode 
(this can be specified on the APING command line), but the 
default is #4INTER. It is recommended that you use one of 
the architected modes discussed in the “What Is a Mode?” 


section. 
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Symbol 


Local values 


2S YMDEST? 


How to determine the value for this symbol Fill in value 
| ‘here | 


The following are the names of the profiles that must be configured. The profile names must be | to 14 
characters long (unless otherwise indicated). The profile names are referenced only on the machine you 
are configuring, and do not need to match any values on other machines. Some suggestions for profile 

names are provided. | 


?CALLLSPRO? 


This is the symbol for the CPI-C side information symbolic 
destination name. It is any 1-8 character name you choose. 
It will be used locally on the AIX machine to refer to a Side 
Information profile. See 1.7, “What Is CPI-C side 
information?” on page 5 for more information on Side 
Information. 


The symbol for the name of the Local Logical Unit 6.2 
profile. Suggested profile name: LUPRO 


The symbol for the name of the Outgoing (CALL) Link 
Station profile. Suggested profile name: CALLLS 


Note: The Link Station profile names are only 1-8 charac- 
ters long. 


TT PNAMEPRO? The symbol for the name of the local Transaction Program 
Name profile. Suggested profile name: If the value for 
7TPNAME? is less than 12 characters long, use the value for 
JTPNAME? followed by “PRO”. For example: 
APINGDPRO. Otherwise, make up a profile name that is 
1-14 characters long. If you will not be running this 
machine as a server, you do not need to configure any local 
Transaction Program Names, and will therefore not need 


this value. 


3.4 Working with APPC configuration 


The following configuration steps will be discussed: 
1. Define yourself to the network 
2. Define a link to a partner or intermediate node 
a. Additional LEN configuration 
b. Other link configuration 
3. Configure to mun as a client 
a. Define CPI-C side information 
b. Other client configuration 
4. Configure to run as a server 
a. Define transaction programs 


b. Other server configuration 
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SNA Server stores its configuration information within encoded profiles that are 
accessed using the System Management Interface Tool (SMIT). SMIT presents 
panels on which you enter your configuration values. All of the values used in AIX 
SNA Server/6000 are case-sensitive, so be sure to always enter profile names and 
other configuration values in the same case throughout the SMIT panels. 


Within SMIT, SNA Server configuration panels can be accessed by selecting the 
following series of panels: 
--Communications Applications 
_ ==SNA Server/6000 
--Configure SNA Profiles 


All other panels referenced in this section are accessed from this base level within 
SMIT. 


You must have the base configuration of AIX SNA Server installed and have 
“system group” access to the system before you can start the SNA subsystem. You 
need “System group” authonty to make the changes described in this document. 
See the document, ALY SNA Server/6000: User's Guide, SC31-7002-01, for more 
information on SNA Server installation. 


This chapter describes a basic configuration that allows both an outgoing and 
incoming APING operation to be performed and describes how to configure a 
workstation that 1s attached to a Token Ring LAN. A token nng DLC must 
already exist on the system. Other DLC’s will require Link Station profile defi- 
nitions that would replace the Token Ring Link Station profile described below. 


You need to define: | 
1. A Control Point Profile 
2. A Token Ring Link Station Profile 


3. A Token Ring SNA DLC Profile 
4. A TP Name Profile (if configured as the server) 


These profiles are optional: 
1. A Local LU (6.2) Profile 
2. A Side Information Profile 


3.4.1 Verifying configuration 
Once the profiles are created, they must be verified using either the command 
verifysna, or in SMIT by following this hierarchy of panels: 


--Advanced SNA Configuration 
--Verify Configuration Profiles 


Before profiles can be used by SNA and APPC, they must be verified with the 
update option (either normal or dynamic, depending whether SNA is running). 
Verification ensures that changes are correct and that no profiles are in conflict with 
each other. Profile additions, changes, or deletions will not take effect until the 
profile database is verified and updated. | 
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3.4.2 Starting and stopping APPC 
APPC is part of the AIX SNA Server/6000 subsystem. You can use the following 
command to test the status of the SNA subsystem: 


sna -display global 


or, for short, 


sna -d g 


If the SNA subsystem is not started, it can be started with the Soiniiand: 


sna -Start sna 


or, for short, 


sna -S 


SNA Server/6000 can be configured to accept incoming link activation requests from 
remote stations automatically without the need for additional “listening” Link 
Station profiles. (These “listening” Link Station profiles were required in SNA 
Services/6000 V1.2). This function, known as dynamic link station ees is con- 
figured by default. 


To stop the SNA subsystem, execute this command: 


Sna -stop sna 


3.5 Configuration 


3.5.1 Starting from Scratch 
If you would like to set your SNA configuration to its default values, run these 
commands: 7 
rm -fr /etc/objrepos/sna/* 
/usr/\pp/sna/bin/mksnadb 


To use these command, you need “root” authority. 


3.5.2 Define yourself to the network 


3.5.2.1. Initial Node Setup 
SNA Server/6000 has one - Control Point profile, node_cp, which is used to identify 
the local node to the network. You must complete the control point profile the 
control point profile before you can start SNA and use APPC. Configuration of 
this profile is handled through Initial Node Setup. The Initial Node Setup function 
also allows you to configure a single link station to provide a link to one remote 
station. This gives the user a single entry point to define the minimum amount of 
information for SNA Server/6000 to operate. 


From within SMIT, Initial Node Setup can be accessed on this panel: 
--Initial Node Setup 
The following figures show the panels that will display using Initial Node Setup. 


The first panel requires you to select the primary link type you will use for this con- 
figuration. You will select token_ring for this example. Be sure to select the appro- 


pniate identifier if the link type you plan to use is not for a Token Ring network. 
The second panel requests the information necessary to configure the Control Point, 
Link Station, and SNA DLC profiles. Replace the symbols (the words beginning 
and ending with question marks) with the corresponding values from the Configura- 
tion Worksheet. 


Choose the DLC type you wish this configuration to token_ring 
represent. 


Figure 17. Initial Node Setup: DLC type 


Control Point name 2LOCALCP? 
Control Point type appn_end_node # see note 
Local network name 2LOCALNET? 

XID node ID * 


# see note 


Optional link station information: 


Link station type 
Link station name 
Calling link station? 
Link address 


token_ring 
2CALLLSPRO? 
yes 
?LANADORESS? 


Figure 18. Initial Node Setup: Information 


Note: By default, your machine is configured as an APPN End Node. Change this 
value only if you are certain that you are to function as an APPN Network Node. 


Note: It 1s not recommended that you use an XID node ID for configuration. See 
Appendix A, “Using Node [Ds in VTAM” on page 143 for a discussion of whether 
you should, and if so, what value to use here. 


3.5.3 Configure to run as a client 
To configure as a client, the following information needs to be configured: 


¢ the modes to be used (unless using predefined modes already provided with the 
product), and, 


¢ optionally, Local LU or Side Information, or both. 


3.5.3.1 Defining Side Information 
Some applications, like APING, do not require side information. These applica- 
tions use programming calls available on a particular platform to dynamically create 
side information when running. SNA Server/6000 provides the programming calls 
that alow APING (and other applications) to do this dynamic definition, so you do 
not need to create a Side Information profile for APING. For those applications 
that require Side Information, this is how to create a profile: 


From within SMIT, the Side Information panel can be accessed by following this 
series of panels: 


--Advanced Configuration 
--Sessions 
--LU 6.2 
--LU 6.2 Side Information 
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The following figure shows the Side Information panel. Replace the symbols (the 
words beginning and ending with question marks) with the corresponding values 
from the Configuration Worksheet. 


Profile name "2SYMDEST 2?" 
Local LU or Control Point alias 
Partner LU alias 
Fully qualified partner LU name “2PARTHERNET?. 2PARTHERLU?" 


Mode name = “?MODE?" 

Remote transaction program name (RTPN) = "“2TPNANE?" 
RTPN in hexadecimal = no 

Comments . airs 


Figure 19. Side Information 


3.5.3.2 Create a Local LU 6.2 Profile 
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You can also add The Local LU 6.2 profile if you plan to use a local LU name that 
is different from the local CP name. If you create a local LU name using a LU 6.2 
Local LU profile, then the local LU alias field in that profile must be specified in 
the “Local LU or Control Point alias” field in the Side Information profile. If no 
local LU alias is specified in the Side Information profile, or side information is not 
used with aping, the local CP name wiul be used as the local LU by default. 


The local LU name definition follows. 


From within SMIT, this can be accessed via: 


--Advanced Configuration 
--Sessions 
--LU 6.2 
--LU 6.2 Local LU 


The following figure shows the Local LU profile panel. Replace the symbols (the 
words beginning and ending with question marks) with the corresponding values 
from the Configuration Worksheet. 


?LUPRO? 
?LOCALLU? 
?LOCALLU? 


Profile name 

Local LU name 

Local LU alias 

Local LU is dependent? 


nH oH oft 


If yes, | 
Local LU address 
SSCP ID 
Link Station Profile name 
Conversation Security Access List Profile name 


Figure 20. Local LU6.2 profile 
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3.5.4 Configure to run as a server 


3.5.4.1 Define local transaction programs 
To run AIX as a server, you must define the transaction programs (TPs) on your 
machine with which a client can start a conversation. For each TP, you must 
define a TP profile. (If you will not be running this machine as a server, you do not 
need to create the Transaction Program Name profile.) 


3.5.4.2 Create Transaction Program Name Profile 
From within SMIT, the Transaction Program Name profile panel can be accessed 
by following this series of panels: 


--Advanced Configuration 
--Sessions 
--LU 6.2 
--LU 6.2 Transaction Program Name 


The following figure shows the Transaction Program Name profile panel. Replace 
the symbols (the words beginning and ending with question marks) with the corre- 
sponding values from the Configuration Worksheet. You'll also need to change any 
other values that are highlighted. 


2T PHAME PRO? 
2T PHAME ? 


Profile name 
Transaction program name 


Transaction program name is in hexadecimal? 


PIP data? 
If yes, subfields 
Conversation type 
Sync level 
Resource security level 
If access, Resource Securit 


Full PATH to TPN executable 
Multiple instances supported? 
User ID 

Server synonym name 

Restart action 

Communication type 


Te | i | | | | i <r | | Pr | | | 


no 
0 

mapped 

confirm 

none 

Access List Prof. = 
2TPPATH? 

yes 

100 


once 
signals 


If IPC, Communication IPC queue key = 0 


Standard input file/device = 
Standard output file/device 
Standard error file/device 


Figure 21. TP Name profile 


3.6 Running APING 


/dev/nul] 
/dev/console 
/dev/console 


You can specify the CPI-C side information symbolic destination name on the 


APING command Like this: 
aping -n ?SYMDEST? 


or, you can supply the fully qualified LU name of the partner like this: 


aping ?PARTNERNET?.?PARTNERLU? 
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3./ How to find... 


- LU name 
The LU name is specified in a Local LU6.2 profile as the “Local LU name” 
parameter. 

e Network name 
The network name 1s specified in the Control Point profile, node_cp as the 
“Local network name” parameter. 

¢ Control Point (CP) name 


The CP name ts specified in the Control Point profile node_cp as the “Control 
Point name” parameter. 


e LAN address 


The LAN address is hard-coded on the Token-Ring adapter in the AIX 
machine or 1s over-ndden by a value called the “locally administered LAN 
address. It 1s a 12-digit hexadecimal value. You can find the LAN address by 
running the command Isefg -v. The LAN address 1s specified by the Network 
Address parameter under the tok0 resource. This parameter will specify the 
locally administered address if there is one. 
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4.0 AS/400 Configuration 


This chapter describes configuration for APPC on the AS/400. The chapter uses a 
step-by-step methodology to describe how to configure APPC communications on 
the AS/400 with an IBM token-nng adapter connection to the network. 


4.1.1 Prerequisites 
¢ APPC/APPN support is part of the OS/400 operating system of AS/400. 


¢ Token ring adapter 


For more information refer to the following publications: 
¢ AS/400 Programming Reference Summary, SC21-8076 
¢ AS/400 Programming: Control Language Reference, SC41-0030 
¢ AS/400 Communications APPC Programmer's Guide, SC41-8189 
© AS/400 Communications APPN Guide, SC41-8188 
¢ AS/400 System Operator's Quick Reference, SX41-9573 


4.2 Terminology 


The terminology table maps the standard networking terms defined in 1.10, “How 
do I Configure a Network?” on page 7 to the terms used by the AS/400. 


Local Adapter Address 
LAN Remote Adapter Address 


4.3. AS/400 APPC Configuration Worksheet 


Use the following worksheet to determine all the values you will need to configure 
this platform. The worksheet is split into two parts: values determined by referring 
to the Guide introduction or other platform chapters, and values that are local to 
this platform which you create. There are three columns. The left-most column 
has a variable name that starts and ends with a question mark (?), the middle 
column describes what the variable is used for and how to determine its value, and 
the nght-most column is left blank so you can fill in a value. Whenever there is a 
reference in this chapter to a value in the left column, substitute the value you have 
written in the nght column. | | 
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For example, if you are following our excellent recommendations, you will wnte 
#INTER in the nght column on the ?MODE? line. Then in Figure 27 on page 47 
you will type #INTER on the AS/400 screen that looks like this: 


Modename ==> #INTER 


Symbol How to determine the value for this symbol | Fill in value | 
here 


Values that much match with other places 


?7LOCALLU? 
?7LOCALCP? 


27LOCALNET? 


This is the symbol that refers to the LU name of the machine 
you are defining to the network. 1 to 8 character field consisting 
of alphanumeric characters which is the LU name of the node. 
Choose a name that is unique within the same network name. 
Refer to 1.10, ““How do I Configure a Network?” on page 7 for 
more information about LU names. 


This is the symbol that refers to the Control Point name of your 
machine. It should be the same as your 7LOCALLU?. Refer to 
1.9, “What Is APPN?” on page 6 for more information about 

control points. 


This is the symbol that refers to the network name of the 
machine you are defining to the network. | to 8 character field 
consisting of alphanumenic characters. There is a structured 
format for the network name which includes the country code, 
enterprise code and network suffix code. This format insures 
uniqueness around the world. Call your local IBM branch office 
for the format information and to register your network name. 
Refer to 1.10, “How do I Configure a Network?” on page 7 for 
more information about network names. 


27PARTNERLU? 


This is the partner's LU name. Refer to the “How to find...” 
section of the partner computer’s configuration chapter for this 
value. Refer to 1.10, “How do I Configure a Network?” on 

page 7 for more information about the partner LU name. 


2?PARTNERCP? This is the Control Point(CP) name of your partner. Refer to 
the “How to find..” section of the partner computer’s configura- 


tion chapter for this value. 


?PARTNERNET? | This is the symbol for the network name of the partner com- 
puter. Use the network name from the partner computer’s “How 
to find...” section. Refer to 1.10, “How do I Configure a 
Network?” on page 7 for more information about the partner 


network name. 


?7LANADDRESS? 


This is the symbol for the LAN Address of the partner com- 
puter. (Or the LAN Address of a network node, if the link 1s 
being made to a network node.) Refer to the “How to find...” 
section of the partner computer’s configuration chapter for this 
value. 


YJTPNAME? This is the symbol for the Transaction Program name. This ts 
the name of the transaction program at the partner computer. 


For APING, the TP Name on the server is APINGD. 
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| Symbol How to determine the value for this symbol Fill in value 
here 


?MODE? This is the symbol for the mode name. See 1.6, “What Is a 
Mode?” on page 5 for a discussion of modes. Often, a 
client/server product’s documentation specifies what mode must 
be used by that product. APING can use any mode (this can be 
specified on the APING command line), but the default is 
#INTER. It is recommended that you use one of the architected 
modes discussed in the “What Is a Mode?” section. 


?NODEID? This is the symbol for the node identifier. Refer to 1.9.3, “ What 
is a Node Identifier?” on page 7 for information on whether or 
not you need this value, and if so, how to define it. If you do 
use the node identification, the recommended/?/required 
IDBLOCK value (the first part of the node ID) on this platform 
is 056. 


Local values 


2?CONTRNAME? 


This is the symbol for the controller description name. 1 to 10 
letters or numbers which will be used as a local name on the 
AS/400 machine to refer to the controller description. You can 
choose any name you like, but since you will use this name later 
to refer to this controller, choose a meaningful name (such as 
PARTNERCP). 


This 1s the symbol for the device descnption name. | to 10 
letters or numbers which will be used as a local name on the 
AS/400 machine to refer to the device descnption. You can 
choose any name you like, but choose a meaningful name (such 
as PARTNERLU). Note: These device descriptions are auto- 
matically created for APPN(*YES) controllers. 


This is the symbol for your AS/400’s APPN node type. This 
can be *ENDNODE to be configured as an end node, or 
*NETNODE to be configured as a network node. 


?DEVNAME? 


2NODETY PE? 


ILINENAME? This is the symbol for the line description name. 1 to 10 letters 
or numbers which wiull be used as a local name on the AS/400 
machine to refer to the line description. You can choose any 
name you like, but since you will use this name later to refer to 
this controller, choose a meaningful name (such as TRLANXX, 


where XX is the LAN adapter number) 


2RESNAME? This is the symbol for the resource name. You can use the 
command “WRKHDWRSC‘ to find out the resource name of 


the adapter you are using. 


WRKHDWRSC TYPE (*CHN) 


2PLUALIAS? This 1s the symbol for the partner LU alias. 1 to 8 characters 
that designates a nickname for the Partner LU. Alias names are 


case sensitive. (Suggestion: PARTLU0O) 


This is the symbol for the CPI-C side information symbolic des- 
tination name. It is any 1-8 character name you choose. It will 
be used locally on the AS/400 machine to refer to a CPI-C side 

information entry. (Suggestion: PLUALIAS) 


2SYMDEST? 
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4.4 Working with the AS/400 


4.4.1 Starting/stopping APPC 
Before you can start APPC, the Line Description which is being used for communi- 
cations must be activated. 


You can start and stop a Line Descnption by using the VRYCFG command. To 
activate or start a line between two systems type the following from the command 
entry (CL commands): 


VRYCFG CFGOBJ(2LINENAME?) CFGTYPE(*LIN) STATUS(*ON) 


To stop a link type the following from the command entry: 


VRYCFG CFGOBU(?LINENAME?) CFGTYPE(*LIN) STATUS(*OFF) 


You can start and stop an APPC controller by several methods. 
¢ VRYCFG command 
¢ Following menu panels 
¢* WRKCFGSTS command 
* VRYCFG 


The VRYCFG command can be used to activate and deactivate a controller, or 
link. To activate or start a link between two systems type the following from 
the command entry (CL commands): 


VRYCFG CFGOBJ(2CONTRNAME?) CFGTYPE(*CTL) STATUS(*ON) 


To stop a link type the following from the command entry: 


VRYCFG CFGOBJ(2CONTRNAME?) CFGTYPE(*CTL) STATUS (*OFF) 


e Menu panels 


To activate or start a link between two systems using menu commands, follow 
this sequence: 


-- AS/400 Main panel 
-- 7. Define or change the system 
-- 1. Configuration 
-- 1. Configure devices and communication 
-- 2. Configure communications and remote hardware 

-- 1. Work with communications controllers 

-- 8. next to desired ?CONTRNANE? entry. 

-- l. or 2. for Vary on or Vary off 


¢ WRKCFGSTS 
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The WRKCFGSTS command can be used to activate and deactivate a con- 
troller, or link. To activate or start a link between two systems type the fol- 
lowing from the command entry (CL commands): 


WRKCFGSTS (*CTL) 


Type 1 to vary on and type 2 to vary off 
the desired controller or device description. 


4.4.2 Other Commands 
¢ APING.DOC - Refer to the APING documentation for how to compile the 
APING and other programs on the AS/400. 


4.5 Configuration 


4.5.1 Working with APPC configuration 


The following configuration steps will be discussed: 
1. Define yourself to the network 
2. Define a link to a partner or intermediate node 
a. Additional LEN configuration 
b. Other link configuration 
3. Configure to mun as a client 
a. Define CPI-C side information 
b. Other client configuration 
4. Configure to run as a server 
a. Define transaction programs 
b. Other server configuration 
When using AS/400 APPC configuration commands, you can enter the commands 
in one of three ways: 
¢ Using the command prompt: Enter the command and press PF4(Prompt). 


¢ Using direct entry: Enter the command and its parameters following the syntax 
described in the CL Reference | 


¢ Proceeding through a senes of menu driven panels. 
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4.5.2 Define yourself to the network 


1. To communicate within an APPN network you must have an LU name. 


During the AS/400 installation process, at least one LU name was configured. 
Your local LU is displayed on the Display Network Attnbutes panel. You can 
view this display either by using the DSPNETA command, or by following this 
sequence of panels: 


-- AS/400 Main panel 
-- 7. Define or change the system 
-- 1. Configuration 
-- 4, Network management 
-- 1. Display network attributes 


You will see a panel similar to the following: 


Display Network Attributes 


Current system name 

Pending system name 

Local network ID 2LOCALNET? 
Local control point name 2LOCALCP? 


Default local location ?LOCALLU? 
Default mode BLANK 
APPH node type 2HODETY PE? 
Maximum number of intermediate sessions 

Route addition resistance 

Server network ID/contral point name . 


Figure 22. DISPLAY NETWORK ATTRIBUTES. This screen displays the configured 
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network attributes. 


If you wish to change the network attnbutes, use the command CHGNETA 
command or follow this panel sequence: 


-- AS/400 Main panel 
-- 7. Define or change the system 
-- 1. Configuration 
-- 4. Network management 
-- 2. Change network attributes 


For APPC on the AS/400, an entry called a communications entry must be 
created in a subsystem to handle APPC program evoke (or allocate) requests. 
To check to see if the communications entry has already been defined: 


a. Type WRKSBS 
b. Type 5 in the blank next to your communications subsystem (ex. QCMN) 
c. Type 8 to view Communications Entnes or Type 9 to view Remote 


Location Entry. 


If there is not a Communications Entry for device APPC, you must add one. 
To add a Communications Entry, the communications subsystem must be 
stopped. To stop the subsystem, use the following commands. 


¢ Type WRKSBS 


¢ Type 4 to end the subsystem 


For further information, see the AS/400 Operators Guide. To add a Communi- 
cations Entry for device APPC, type the CL command ADDCMNE: 


ADDCHNE 
Subsystem Description 
Library 


Remote Location 


Job Description > QOFTJOBD 
Library 
Default User Profile > QUSER 
: > *ANY 


> *NOMAX 


Figure 23. ADD COMMUNICATIONS ENTRY. This screen displays the Add Commu- 
nications entry parameters. 


The subsystem must be stopped and restarted for the communications entry to 
be added. 


4.5.3 Define a link to a partner or network node 
There are three ‘descriptions’ used for APPC communications on the AS/400. 
These are: 


¢ Line Description 


The line description describes the physical line connection to be used between 
the AS/400 and the network. 


¢ Controller Descnption 


The controller description is used to describe all the characteristics of a link to 
an adjacent computer. 


e Device Description 


The device description is used to descnbe all the characteristics of the logical 
connection between two locations in the network. 


The AS/400 has a feature called automatic configuration. APPN Controllers are 
auto-created if the line description is defined with Automatic configuration can be 
used to autocreate a device description and/or a controller descnption on the 
AS/400. The autocreate happens when a partner tres to start a conversation with 
the AS/400. 


The below configuration directions descnbe how to create or change line, controller, 
and device descriptions. If you wish to autocreate a controller and/or device 
description, you can skip those respective steps.: 


1. Create or change line description: You must have a line description to be used 
with the controller descnption. If there is a line descnption already available, 
you should not create a new one and can skip this step. This example creates a 
token ring line descnption named TRLAN. To create or change line 


AS'400 Configuration 45 


descriptions for token-ring, use CRTLINTRN or CHGLINTRN (create or 


change T-R line). 


CRTLINTRN 
Line Description 
Resource name 
Online at IPL 
Vary on wait 


Maximum contol lers 
Line speed 

Maximum frame size 
Local adapter address 


2LINENAME? 
2RESHAHE? 
*YES 
*NOWAIT 


Figure 24. CREATE/CHANGE LINE DESCRIPTION. This screen displays the Line 


Description attributes. 


2. Create or change controller description (link definition): You can access con- 
troller descnptions through the CRTCTLAPPC or CHGCTLAPPC commands 
(Create/Change Controller Descnption, APPC). The following example shows 
only the fields of the controller description that need to be changed. You can 


allow the other fields to default. 


CRICTLAPPC 
Controller Description 
Link type 
Online at IPL 
APPN-capable 
Switched line list 
Remote network identifier 
Remote control point 
LAN remote adapter address 
APPN CP session support 
APPH node type 
APPN transmission group number 


2CONTRNAHE? 
*LAN 

*YES 

*YES 
2?LINENAHE? 
?PARTHERNET 2 
2?PARTHERLU? 
?LANADDRESS? 


> *YES 


*CALC 


Figure 25. CREATE/CHANGE CONTROLLER DESCRIPTION. This screen displays 
the Controller Description attributes. 


3. OPTIONAL STEP FOR APPN(*YES) devices: Create or change device 
descnption (LU definition): You can access controller descriptions through the 
CRTDEVAPPC or CHGDEVAPPC commands (Create/Change Device 
Description, APPC). The following example shows only the fields of the device 
description that need to be changed. You can allow the other fields to default. 


CRIDEVAPPC 
Device Description 
Remote Location 


2DEVHAME ? 
2PARTHERLU? 
2LOCALLU? 


2PARTNERHET ? 
2CONTRNAME 2 


Figure 26. CREATE/CHANGE DEVICE DESCRIPTION. This screen displays the 
Device Description attributes. | | 
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4.5.4 Configure to run as a client 


4.5.4.1 Define CPI-C side information 
To use a CPI-C symbolic destination name, a CPI-C side info entry or CSI should 
be defined. 


The following are CL commands that allow you to create, display, print, change, 
delete and work with the side information. 

¢ CRTCSI- Create the *CSI 

¢ DSPCSI - Display or print the *CSI object 

¢ CHGCSI - Change the *CSI object 

¢ DLTCSI - Delete the *CSI object 

¢ WRKCSI - Provides a menu interface for the *CSI object 


CRTICSI 
Side Information ?SYMDEST ? 
Library 
Remote Location ?PARTHERLU? 
2TPNAME ? 


Additional Parameters 
Local location 2LOCALLU? 
2HODE? 
2PARTNERNET ? 


Figure 27. CREATE CPI-C SIDE INFORMATION. This screen displays the CPI-C Side 
Information parameters. Press PF10 for Additional parameters. 


4.5.5 Configure to run as a server 


4.5.5.1 Define transaction programs 
To run AS/400 as a server, you must, in addition to the configuration steps above, 
define a transaction program (TP) on your machine which will be started when the 
chent establishes a conversation. | 


_ To define the TP for AS/400, the User Library List needs to list the library that 
contains the transaction program. If the library that contains the TP is not in the 
list, it should be added. To access the User Library List do the following: 


¢ Type the WRKSYSVAL from a command line 
¢ Page down until you find the QUSRLIBL system value. 
¢ Select 2 for Change 


¢ Type your server program’s library name (e.g. APING) in the space next to the 
desired sequence number. The library should contain the server program to be 
started (e.g. APINGD) 
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¢ Stop and restart your communications subsystem in order to update the 


subsytems and User Library List. To stop your communication subsystem, use 
the following commands: 


— Type STRSBS 

— Type your subsystem name and press Enter 

To start your communication subsystem, use the following commands: 
— Type WRKSBS 

— Type 4 to end the subsystem 


4.6 Running APING 


You should now be able to APING any of the computers you configured to using 
the steps above. 


To run APING, from the AS/400 command line, type the CL command CALL 
from the command entry line. 


Call Program (CALL) 


Program 
Library 
Parameter 
or?PLUALIAS? 


Figure 28. CALL program. This screen displays the Call program parameters. 


4.7 How to find.... 


¢ LU name 


Durning the AS/400 installation process, at least one LU name was configured. 
Your LU name can be found on the Display Network Attnbutes panel. Use 
DSPNETA command or follow this panel sequence. 


-- AS/400 Main panel 
-- 7. Define or change the system 
-- 1. Configuration 
-- 4, Network management 
-- 1. Display network attributes 


On the Display network attributes panel, the LU name is the Default local 
location. 


¢ CP name 


On the Display.network attributes panel, the CP name 1s the Local control . 
point name. ' | 


e Network Name 


On the Display network attributes panel, the Network Name is the Local 
network ID. 


48 Multi-Platform Config 


LAN address 

the LAN address is found by accessing the line description. 

- Type “*WRKLIND *TRLAN” (Work with line descriptions) 

— Page down to the Token-Ring line description entry 

— Type “S” infront of the Token-Ring line description entry to Display 


— Look in the panel entry for Local Adapter Address. This is the value that a 
partner will enter for its remote address when connecting. 
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5.0 CICS Configuration 


The Customer Information and Control System (CICS) provides an environment 
optimized for running very short programs called transactions on System/370 and 
System/390 processors. Transactions consist of a program (that may perhaps call 
other programs) with an associated transaction identifier or transaction ID. The 
transaction ID is 1-4 characters long but typically is always four characters. For 
example, the transaction CEDA starts the program that performs on-line resource 
definition. 


This chapter descnbes how to configure CICS to use the APING and APINGD 
sample programs. 


5.1.1 Prerequisites 
The following software levels are required for the definitions in this chapter: 


¢ CICS/ESA Version 3 Release 3 

¢ ACF/VTAM Version 3 Release 4.1 or Version 3 Release 3 

¢ MVS/ESA Version 4 Release 3 or Version 4 Release 2 

¢ NCP Version 5 Release 2 or later 

¢ Token mng adapter 
In most cases, you will find CICS has already been installed and an LU name has 
been assigned. In addition, you will almost certainly find VITAM installed and the 
network name has already been defined. Therefore, while we give instructions on 
how to set the LU name in CICS and VTAM, you probably wul not need to make 


any changes. The information is very useful, however, because you wiull need it to 
configure other platforms that wish to communicate with CICS. 


In addition, you should have the APING and APINGD sample programs for CICS. 
These publications provide detailed information on the configuration process for 
_ CICS Version 3 Release 3 and VTAM Version 3 Release 4.1. 
© CICS/ESA: Resource Definition (Online), SC33-0666 
¢ CICS/ESA: System Definition Guide, SC33-0664 
¢ VTAM: Resource Definition Reference, SC31-6438 
¢ VTAM: Network Implementation Guide, SC31-6434 
¢ NCP: Resource Definition Reference, SC30-3448 ~- 


5.2 Terminology 


Below is a table of standard APPC terms and the equivalent CICS terms. Using 
standard terms makes configuring two unlike platforms easier so standard terms are 
used whenever possible. Some terms have no CICS equivalent but instead are set in 
VTAM or NCP. 
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CICS Term | 
PU name (VTAM) 


Network Name Network, NETID (see note) 


Note: CICS uses network name only when defining CPI-C side information. 
VTAM keeps track of partner LUs and routing traffic to the partner LUs, in the 
same network or different networks. 


9.3 CICS Configuration Worksheet 


Use the following worksheet to determine all the values you will nced to configure 
this platform. The worksheet is split into two parts: values determined by referring 
to the Guide introduction or other platform chapters, and values that are local to 
this platform which you create. There are three columns. The left-most column 
has a variable name that starts and ends with a question mark (?), the middle 
column describes what the vanable is used for and how to determine its value, and 
the nght-most column is left blank so you can fill in a value. Whenever there is a 
reference in this chapter to a value in the Ieft column, substitute the value you have 
wnitten in the nght column. 


For example, if you are following our excellent recommendations, you will write 
#INTER 1n the nght column on the 7fODE? line. Then in Figure 36 on page 64 
you will type #INTER on the CICS screen that looks like this: 


MOdename ==> #INTER 
Likewise, in Figure 33 on page 61 the substitution would look like this: 
?PARTNERLU? LU LOCADDR=0,ISTATUS=ACTIVE, X 


MODE TAB=?MODETABLE? , DLOGMOD=#INTER 
How to determine the value for this symbol Fill in value 
here 


Values that must match in other places 


?7LOCALLU? 


This is the LU name of the CICS region you are configuring. It 
can be 1-8 characters (letters or numbers) but must begin with a 
letter. In CICS this is called the APPLID; in VTAM this ts 
called the APPLID or ACBNAME. Refer to 1.10, “How do I 
Configure a Network?” on page 7 for information on how to 
define this value. If CICS is installed and running, you will not 
be able to choose this, you will have to get this value from the 
CICS or VTAM system programmer. 


This is the network name, called the NET/D in VTAM. It can 
be 1-8 characters (letters or numbers) but must begin with a 

letter. CICS uses the value defined in VTAM. See 5.7, “How to— 
find...” on page 71 for information on how to find this value. 


?7LOCALNET? 
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~ee 


How to determine the value for this symbol Fill in value— 
here 


2?LOCALCP? This is the Control Point name of your machine. It can be 1-8 


characters (letters or numbers) but must begin with a letter. It’s 
?PARTNERCP? 


value is set in VTAM, where it is called the SSCPNAME. See 
5.7, “How to find...” on page 71 for more details. 


This is the Control Point name of the partner computer. 
VTAM uses this name in the CPNAME parameter to identify 

partner computers. Refer to the “How to find...” section of the 
partner computer’s configuration chapter for this value. 


2?PARTNERLU? This is the partner’s LU name. CICS calls this the netname. 
‘This is NOT the same as the 7LOCALNET? name descnbed 
earlier. Refer to the “How to find...” section of the partner com- 
puter’s configuration chapter for this value. In many cases this 


value will be the same as the preceding value (7PARTNERCP?). 


?PARTNERNET? | This is the network name of the partner computer. VTAM does 
all processing of network name Use the network name from the 
partner computer’s “How to find...” section. If this value is dif- 
ferent than the value for 7LOCALNET?, special coding is 


required in VTAM (see Figure 34 on page 61 for an example). 


2?LANADDRESS? | This is the LAN address of the network processor that connects 
the host to the LAN. It is 12 hexadecimal digits (for example, 
x’ 10005A25EEF0’ or x’400085950001’). This chapter assumes 
that the network processor 1s an IBM 3745 running NCP V5R2 


or later. 


VTAM’s preferred method for connecting to APPN or LEN 
nodes requires the partner computer to initiate the connection. 
This relieves VTAM (and VTAM system programmers) from 
having to know the LAN Address of the partner computer. 
VTAM uses the 7?PARTNERCP? name to identify the partner. 


APINGD 


APIN 


#INTER 
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7TPNAME? This 1s the Transaction Program name. It 1s the name that ts 
sent across the network to the server machine and can be 1-64 
characters, including a period (.). The server machine then maps 
this TP Name to an executable program. The TP Name is 
usually specified in a client/server product’s documentation. For 
APING, the default TP Name is APINGD but this can be 


changed. 


29SERVERTRAN? | A 4 character name for the CICS server transaction, that is, the 
transaction initiated by an APPC partner LU. This must match 
the first four characters of the Transaction Program name and - 


must be in upper-case. 


?2MODE? See 1.6, “What Is a Mode?” on page 5 for a discussion of 
modes. Sometimes a client/server product’s documentation spec- 
ifies what mode must be used by that product. APING can use 
any mode (this can be specified on the APING command line), 


but the default is #INTER. 


Local values | 


Variable How to determine the value for this symbol | Fill in value 
~~ eerie lee 
?LINK NAME? ] to 8 letters or numbers which will be used as a local name to 

refer to the link to a partner computer. You can choose any | 
name you like, but since you will use this name later to refer to 

this link, choose a meaningful name. CICS relies on VTAM to 

handle this type of information. VTAM calls the link name the 

PU name and it must begin with an alphabetic character. See 

Figure 33 on page 61 for more information. 


29SYMDEST? This is the CPI-C side information symbolic destination name. 
It is any 1-8 character name you choose. CICS does not require 


you to create side information. Example: JOE. 


Profile names, file names - these are names of CICS resources or members of MVS datasets. 
otherwise noted, you can choose any name you want. 


?7PROCLIB? 


?CICSPROC? 


The dataset that contains the CICS start-up procedure. This 
procedure library should already exist and will probably have a 
member for CICS. Examples: SYS1.PROCLIB or 
IPO!1.PROCLIB. 


The procedure name (a member in °PROCLIB?) that starts 
CICS. This job must run after the VTAM application node 
(APPL) is active. Example: CICS330. 


The dataset with just those CICS System Initialization Table 
(SIT) parameters that are set at start-up time. There are several 
dozen SIT parameters. If several CICS regions have the same 
settings for most of them, they can use the same pre-assembled 
table but change the ones that need to be unique (like the LU 
name) when starting CICS. One way to do this is with a dataset 
containing the parameters to be changed. Example: 


CICS330.SYSIN(DFHSSIP 1). 


The VIAM switched major node containing the PU definition 
for the remote peripheral node (if the partner LU is in a DOS, 
OS/2, ATX, or OS/400 or other APPN platform). VWTAM 
V3R4, the basis for the examples 1n this book, has a feature that 
dynamically creates the PU definition. This may already be 
defined. Example: LANSW. 


The VTAM application major node with the CICS APPL state- 
ment. This must be varied active before starting CICS. This 
typically will already exist so contact your VTAM systems pro- 
grammer for this. If you are looking on your own, it will usually 
have APPL in the name. Example: CICSAPPL. 


?STTPARMS? 


ISWNETNODE? 


27APPLNODE? 


2?GROUP? A 1-8 character name for the collection of CICS definitions. 
CICS reserves for its own use names beginning with DFH. You 
can choose any name. Examples: OS2 or AIX. 

2?CON? A 1-4 character connection name used as a nickname for the 


partner LU. The CICS connection defines the partner LU. 
Several other parameters are tied to the connection name. It 
does not have to match anything outside CICS. Example: 
DWALT. 
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?CLIENTTRAN? 


2?CLIENTPGM? 


27SERVERPGM? 


?7PROFILE? 


2?APINGLIB? 


?MODETABLE? 


A 1-4 character name for the CICS client transaction, that 1s, a 
transaction started by a terminal user signed on to this CICS 
region. Example: APNG. 


A 1-8 character name for the client program. This typically is 
the same as the real program name and this chapter will use that 
convention. Example: APING. 


A 1-8 character name for the server program. This typically is 
the same as the real program name and this chapter will use that 
convention. Example: APINGD. 


A 1-8 character name for the partner charactenstics in CICS’ 
CPI-C side information. See 5.5.5.1, “Define CPI-C Side Infor- 
mation (OPTIONAL)” on page 66. 


The load library containing the compiled and link-edited pro- 
erams for APING and APINGD. Example: 
CICSAPPS.LOADLIB. 


The binary table containing mode names that VTAM searches, 
usually a member of SYSI.VTAMLIB. This may already exist 
but may not have the preferred mode names (#INTER, 

#BATCHI, etc.) Check to make sure. Example: APPCMODE. 


5.4 Working with CICS and VTAM 


This section describes commands that you (or an MVS system operator) must issue 
from an MVS operator console to make CICS and VTAM work. There are pro- 
grams like the JES Spool Display and Search Facility (SDSF) that allow authonzed 
users to view the system log and enter MVS commands from any 3270 session. If 
you have such a program then you don’t have to be at the System/390 console to 


~ issue these commands. 


VTAM definitions are grouped into major nodes, each of which is a separate 
member of SYSI.VTAMLST. The VBUILD TYPE= statement determines the 
type of major node. The two types you will use are application major nodes and 
switched major nodes. Application major nodes define host LUs using APPL state- 
ments, while switched major nodes define peripheral nodes using PU statements: and 
LU statements. All of these will be descnbed in more detail. 


5.4.1 Starting/stopping APPC | 


APPC is part of CICS; it starts. automatically when CICS is started, and stops auto- 
matically when CICS is stopped. Starting CICS consists of two steps: 


1. Starting the VTAM application major node that contains the CICS APPL defi- 
nition. To do this, issue the following command from the MVS operator 
console: 


v net,act,1d=?APPLNODE? 


CICS Configuration 55 


2. Running an MVS job that starts CICS. This job (called a procedure or proc) is 


usually in a procedure library such as SYS1.PROCLIB. To start CICS, issue 
following command from the MVS console: 


s 2CICSPROC? 


The procedure can be included in the MVS start-up list or a system operator can 
run it from the console. For more details on the start-up proc, see 5.5.2, “Defining 
yourself to the network” on page 57. 


5.4.2 Other commands 
Other MVS and CICS commands that are necessary or just useful include the fol- 


lowing: 
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MVS console commands 


¢ If the partner LU 1s in a computer connected to an NCP (a common case for 


CICS), the VTAM definition for the partner computer must be active before the 
computer can even connect to NCP. (There are some exceptions to this. Sce 
VTAM: Network Implementation Guide, Chapter 5, Section 2 for more details.) 
In VTAM, a switched major node is a set of definitions for partner computers 
on a LAN (in this example). The following command activates the switched 
major node and all the partner computer definitions in it: 


v net,act, id=?SWNETNODE? 


If the major node is active the following commands deactivate and activate the 
link to the partner computer: 


v net,inact, id=?LINKNAME?, f 
v net,act, id=?LINKNAME? 


Displaying an active LU shows all the sessions and session partners of that LU. 
The following commands display the CICS LU and the partner LU. 


d net, id=?LOCALLU?,e 
d net, id=?PARTNERLU? ,e 


CICS Commands 
¢ In CICS, the CEMT transaction allows you to display and modify the status of 


connections, netnames, and modenames (that is, all sessions with a particular 
mode name): | 
cemt ing conn(?CON?) 


cemt ing netname(?PARTNERLU?) 
cemt ing netname(?HODE?) 


This guide provides instructions for using CICS Resource Definition Online (RDO) 
to create and modify CICS definitions. To start Resource Definition Online, you 
must be logged on to CICS and your user-I[D must be authonzed to run the CEDA 
transaction. | 
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5.5.1. Working with APPC configuration 


The following configuration steps will be discussed: 
1. Define yourself to the network 
2. Define a link to a partner or intermediate node 
a. Additional LEN configuration 
b. Other link configuration 
3. Configure to run as a client 
a. Define CPI-C side information 
b. Other client configuration 
4. Configure to run as a server 
a. Define transaction programs 
b. Other server configuration 


Since CICS’ primary role is as a server, the server discussion will come before the 
client discussion. 


5.5.2 Defining yourself to the network 
Typically, the LU name for CICS has already been defined by the CICS systems 
programmer. If you are logged on to CICS, for example, the CICS LU name 
appears in the lower right corner of the 3270 screen. If this is the case for you, skip 
directly to 5.5.3, ‘Define a link to a partner or intermediate node” on page 60. 


If you must start from scratch, this section describes how to create the CICS LU 
name. The APPLID parameter in the CICS System Initialization Table (SIT) 
determines the LU name for CICS. This macro statements are assembled and link- 
edited into a binary table that CICS loads at start-up tume. The APPLID must 

- match the ACBNAME used in the VTAM APPL statement. 


The APPLID in the System Initialization Table can be over-ndden at start tume by 
including some statements in the start-up procedure. In particular, the APPLID 
can be (and usually 1s) specified this way. Figure 29 on page 58 1s a CICS start-up 
procedure. The dataset with the over-ride parameters must be in the SYSIN DD 
concatenation list. 7 


The highlighted sections are discussed in the notes below. This 1s not the complete 
listing, just the section from the beginning down to the DFHRPL DD statement. 
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//DFHSTART PROC START='AUTO', 
// INDEX1='CICS330', 
// INDEX2='CICS330', 
// REGNAMI=, | 
// REGNAM2=, 
// REG='32M', 
// OUMPTR='YES', 
// RUNCICS='YES', 
// OUTC='*', 
// RORC='A', 
// SIP=1 
etc. 


/ KEKEKKEKRKEK KEK KK EEK KEE KEKE KK KEKRKEKERKEERKREKKEKRREKEEEKREKKEKREKKEKKEKKES 
KREKKKEKEKKKEKKKEKKEKKSR EXECUTE CICS KREKEEKKEKKKEKEKKEEKEKEKKKKEEK 


Ya a al al 


//CICS EXEC PGH=DFHSIP, REGION=8REG, TIME=1440, 
// COND=(1,NE,CICSCNTL), 
// PARM="START=&START, SYSIN' 
//* 
//* THE CAVM DATASETS - XRF 
//OFHXRMSG DD DISP=SHR, 
// OSN=&INDEX1..CNTL.CICS&REGNAM1. . DFHXRMSG 
//OFHXRCTL DD DISP=SHR, 
// OSN=&INDEX1..CNTL.CICS&REGNAM1. .DFHXRCTL 

* 
//* THE “FILEA" APPLICATIONS SAMPLE VSAM FILE 
//* (THE FILEA DD STATEMENT BELOW WILL 
//* OVERRIDE THE CSD DEFINITION IN GROUP DFHMROFD) 
//FILEA DD DISP=SHR, 
// OSN=RINDEX1. .CICS&REGNAM1..FILEA 


ie 3 
//SYSIN DD DSN=?SITPARNS? , DISP=SHR # note 1 
//OFHCMACD DD DSN=CICS330.DFHCMACD, DISP=SHR 
//* THE CICS STEPLIB CONCATENATION 
//STEPLIB DD DSN=EDC.V2R1MO.SEDCLINK,DISP=SHR 
ry DD DSN=&INDEX2. . SOFHAUTH, DISP=SHR 
If DD DSN=SYS1.COB2CICS , DISP=SHR 
// DD DSN=SYS1.COB2LIB,DISP=SHR 
//* DD DSN=IMS.RESLIB,DISP=SHR 
//* THE CICS LIBRARY (DFHRPL) CONCATENATION 
//OFHRPL DD DSN=EDC.V2R1MO.SEDCLINK,DISP=SHR # note 2 
// DD DSN=&INDEX2. .SDFHLOAD ,DISP=SHR 
// DD DSN=2APINGLIB?,DISP=SHR # note 2 
// DD DSN=SYS1.COB2CICS, DISP=SHR 
// DD DSN=SYS1.COB2LIB,DISP=SHR 


etc. 
Figure 29. Startup Procedure for CICS - 7PROCLIB??CICSPROC?) 


Notes: 


1. The ?STTPARMS? dataset contains the overrides to the System Initialization 
Table. This file must be in the SYSIN DD list. 


2. The DFHRPL DD concatenation list is where CICS looks for executable pro-. 
grams and must contain the load library containing the APING and APINGD 
modules. In this example, the load library 1s 7APINGLIB?. 
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Figure 30 on page 59 shows a data set with SIT over-nde parameters, in particular 
the APPLID. Once CICS has started, these parameters become part of the SIT for 
this CICS region. 


S1T=6$, 

XRF=NO, 

SEC=YES, 
XAPPC=YES, 
XCMD=NO, 
XDCT=NO, 
XJCT=NO, 
XPCT=NO, 
XPPT=NO, 
XTST=NO, 
XTRAN=YES, 
XFCT=NO, 
XPSB=NO, 
AUXTR=ON, 
AUXTRSW=NEXT, 
APPLID=(?LOCALLU2),  # note 
ISC=YES , 
GRPLIST=MNFLIST, 
END 


Figure 30. CICS SIT Override Parameters - CICS330.SYSIN(DFHSSIP1) 


Notes: 


1. The APPLID must match the VTAM ACBNAME parameter. 


To define the CICS LU name in VTAM, you wiul need to set up an application 
major node with a minor node for this CICS region. In VTAM, the name of a 
resource (LU, APPL, etc.) is the name that precedes the key word in the definition. 
Figure 31 shows an example of a VTAM application major node with one minor 
node (that is, one APPL statement). 


27APPLNODE? VBUILD TYPE=APPL # note 1 
?LOCALLU? APPL ACBNAME=?LOCALLU? , AUTH=(ACQ, PASS, VPACE) , X  # notes 2,3,4 
MODETAB=?MODETABLE? , EAS=200 , PARSESS=YES , VPACING=0, X  # notes 5,6 


SONSCIP=YES 
Figure 31. VTAM Application Major Node - SYS1.VTAMLSTQ@APPLNODE?) 


Notes: 


1. By convention, the major node name (the label on the VBUILD statement} is 
also the name of the member in SYS].VTAMLST. 


2. The ACBNAME must match the APPLID parameter in the CICS System 
Initialization Table. If the ACBNAME is not specified, it defaults to the name 
directly preceding the APPL keyword (?7LOCALLU? 1m this figure). 


3. The mode table 7?MODETABLE? must contain the mode names used by 
partner LUs that initiate connections to this CICS. WTAM only checks the 
name (the parameters can be anything or nothing). VIAM does not check out- 
bound BINDs for mode names, only inbound BINDs. So you may run into a 
situation where you can acquire a session from CICS successfully but a CNOS 
from a remote system will fail. 
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4. The continuation character (X in this example) must be in column 72, and con- 
tinuation lines (here the MODETAB =...) must begin in column 16. 


5. PARSESS = YES indicates this CICS will use parallel sessions. 


6. Another parameter, APPC, is not coded here because the default, APPC = NO, 
is the desired value. CICS uses its own APPC implementation and does not 
use VTAM’s APPC support. 


There are two mode names that must be in the mode table (7MODETABLE?) 


named in Figure 31 on page 59. They are SNASVCMG and ?7MODE? (the mode 


name from the worksheet in 5.3, “CICS Configuration Worksheet” on page 52). 
The assembler source code in Figure 32 provides working definitions. Add this 
source code to the source code for the mode table, assemble it and re-link it to 
SYSLVTAMLIB. 


TITLE 'SNASVCMG' 


KREKKKKEKEKKKKEKEKKEKRKEKKKEEKKEKKKKKKRKKKKKKEKKEKKEKRKEKRKEEKEKEKRKEKEEKEKKEKEKKKEKKEKREE 


. LOGHODE TABLE ENTRY FOR RESOURCES CAPABLE OF ACTING ‘3 


* AS LU 6.2 DEVICES * 


KKEKREKKEKEKEKEKKEKKEKKRKEKEKKKEKKKEKEKEKKEKEKKKREKRKRKEKEKKERKEKEKKEEKKKKEKRKEEKEKKEERE 


SNASVCHG HODEENT LOGHODE=SNASVCNG, FHPROF=X‘'13',TSPROF=X'07', 
PRIPROT=X'BO' ,SECPROT=X'BO' ,COMPROT=X'DOB1', 
RUSIZES=X '8686' , ENCR=B 'Q000' , SSNDPAC=7, 
PSERVIC=X '060200000000000000000300'," 
SRCVPAC=7 , PSNDPAC=7, TYPE=0 
TITLE Ader? 


KEKE KREKKKKEKKKEKKKKEKREKKEKRKEKKEKKKKKKEKRKKEKKEEKRKKEKRKKREKKKEKRKEKEKEKREKRKEEKKEKEREKE 


et + + 


is LOGHODE TABLE FOR INTERACTIVE SESSIONS ON RESOURCES = 
. CAPABLE OF ACTING AS LU 6.2 DEVICES . 
* * 


KEKKEKEKKKEKKKEKKKKKEKRKEKEKEKKEKEKKKEEEKKEKREKKKERKKEKEKKREREKREKEKKRKEKEKREKEEKKEEKEKKEESK 


#INTER HODEENT LOGHODE=#INTER, m 


ENCR=B'0000' ,SSNDPAC=7, . 
SRCVPAC=7 , PSNDPAC=7 


Figure 32. VTAM Mode Definitions - SNASVCMG and 7MODE? 


5.5.3 Define a link to a partner or intermediate node 


60 


To define a link to a partner or intermediate node, create a VTAM switched major 
node with a physical unit (PU) definition. If the partner LU is in the same system 


(APPC/MVS or another CICS region, for example), skip this section and go to 
5.5.4, “Configure to run as a server” on page 62. | 


Note: The examples here are for APPN nodes and LEN nodes. If the partner LU 


is in another S/390 host, subarea routing must be used and VTAM on both hosts 


must have proper paths defined to allow CICS to communicate with the partner 
LU. 


Since the next node in the path to the partner LU may be just an intermediate hop, 
the term adjacent link will be used to name the link chosen to route the traffic to 
the partner LU. 


For most APPC systems communicating with CICS, the link to the host S$/390 is 
activated by the remote system, not by VTAM. (CICS does not know about link 
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definitions at all.) The examples shown here represent APPN nodes or LEN nodes 
that activate links to VTAM. 


Below is a sample VTAM switched major node. 


2SWNETNODE? VBUILD TYPE=SWNET ,MAXGRP=6 , MAXNO=6 # note 1 

?LINKNAHE? PU ADDR=04, X # note 2 
CPNAME=? PARTNERCP?, X # note 3 
PUTYPE=2, X 
MAXDATA=2057, X 
MAXPATH=1 

2?PARTNERLU? LU LOCADDR=0, ISTATUS=ACTIVE, X # note 4 
MODETAB=? MODETABLE? , DLOGMOD=? NODE? # note 5 

Figure 33. VTAM Switched Major Node - SYSI.VTAMLSTC@SWNETNODE?) 

Notes: 

1. The name of the switched node (?SWNETNODE?) 1s the label of the VBUILD 
statement. 


2. VIAM thinks of PUs as links; this name is strictly internal to VTAM. 


3. The CPNAME in this definition is obtained from the partner (or defined by the 
VTAM system programmer and given to the person setting up the partner com- 
puter). It must match exactly. The network name is by default the same as 
VTAM’s (see 5.7, “How to find...” on page 71). 


4. On the platforms that will use this form of VTAM definition, it is quite likely 
that 7PPARTNERLU? and ?7?PARTNERCP? are one and the same. In fact, for 
Networking Services/DOS, this is a requirement. 


5. VIAM only requires that the mode name be in the mode table. Making it the 
default (DLOGMOD) just makes things tidier. Note that the mode name 
SNASVCMG must also be in the mode table. 


If the partner computer has a different network name than VTAM’s, then you must 
have VTAM Version 3 Release 4 or later to use the following definition. The 
partner computer 1s said to be in a non-native network. 


2SWNETNODE2 VBUILD TYPE=SWNET ,MAXGRP=6 ,MAXNO=6 

2LINKNAME? PU ADDR=04, X 
CPNAME=?PARTNERCP?, X 
PUTYPE=2, X 
HAXDATA=2057, ‘ X 
MAXPATH=1, x 

XNETALS=YES, X # note 1 
NETID=? PARTNERNET? # note 2 

2PARTNERLU? LU LOCADDR=0,ISTATUS=ACTIVE, X 
HODETAB=?MODETABLE? ,DLOGHOD=2? NODE? 


Figure 34. VTAM Switched Major Node, Non-Native Network - 
SYSLVTAMLST@?@SWNETNODE?) 


CICS Configuration 6] 


Notes: 
1. You must code XNETALS = YES here and int the VTAM start options. It is 
only valid with VTAM V3R4 or later. 


2. The NETID is the partner network name from the worksheet in 5.3, “CICS 
Configuration Worksheet” on page 52. 


9.5.4 Configure to run as a server 
To configure CICS as a server you must define the following: 


¢ a CONNECTION object (with the partner LU name) 

¢ a SESSIONS object (with the mode name for the session) 

¢ a TRANSACTION object (with the TP Name to be started) 
* a PROGRAM object (used by the TRANSACTION object) 


In CICS, objects have properties such as authonzation lists (what user-ids can use 
the object), resources required (memory, buffers), etc. CICS manages all these to 
provide low response time. 


Note: To distinguish CICS objects, such as a CONNECTION, a more generic 
usages, the CICS object names will be in upper case. For example, a PROGRAM 
refers to the CICS definition for a program object, while a program can be any exe- 
cutable file or load module. 


To create and modify definitions in CICS start the CEDA transaction. All defi- 
nitions in CICS are kept in groups. Most object identifiers must be globally unique, 
that is, cannot be used in any other group. SESSIONS objects are an exception to 
this rule. In the following sections all the definitions are in the same group. 


9.9.4.1 Defining a CONNECTION 


To define a connection in CICS, type the following at a clear screen: 


ceda define group(?GROUP?) connection(?CON?) 


CICS folds all characters to upper-case, so you don’t have to worry about typing 
lower-case characters. If the group does not exist, CICS will create it for you auto-. 
matically. Figure 35 on page 63 shows the 3270 screen that results from this | 
command. CICS fills in the group name and the CONNECTION identifier from 
the values you typed. On this screen and all other CICS screens, if a value must be 
selected from a list, then the part of the list value that 1s upper-case serves as a 
short-name. For example, the ACcessmethod parameter has options of Vtam, IRc, 
INdirect, and Xm. To select Vtam, typing “V” is the same as typing “VTAM.” 
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OVERTYPE TO MODIFY CICS RELEASE = 0330 

CEDA DEFine 

Connection : 2CON? © note l 
Group : 2GROUP? 

DEscription ==> PARTNER LU 
CONNECTION IDENTIFIERS 

Netname ==> 2PARTHERLU? note 2 
INDsys ==> 
REMOTE ATTRIBUTES 

REMOTESystem ==> 

REMOTEName ==> 
CONNECTION PROPERTIES 

ACcessmethod ==> ; Vtam | IRc | INdirect | Xm 

Protocol => Appc | Lu6él note 3 
SInglesess => No | Yes note 4 
DAtastream => User | 3270 | SCs | STrfield | Lms 

RECordformat ==> U | Vb 
OPERATIONAL PROPERTIES 

+ AUtoconnect ==> No No | Yes {| All # note 5 

ItService ==> Yes Yes | No 
SECURITY 

SEcurityname ==> 

ATtachsec ==> Local Local [| Identify | Verify | Persistent # note 6 

| Mixidpe 
BIHOPassword ==> PASSWORD HOT SPECIFIED 
BINOSecurity ==>- No | Yes 


APPLID=TOCICS3 


Figure 35. CEDA DEFINE GROUPC@GROUP?) CONNECTION 


Required parameters: 
1. Connection is a 1-4 character nickname for this partner LU. 


2. Netname is the partner LU name. The netname must match a VTAM defi- 
nition, either from a dynamically-defined cross-domain resource (CDRSC) or 
from a Static definition in a VTAMLST member. (See Figure 33 on page 61.) 
CICS uses netname to refer to 7?PARTNERLU? and doesn’t allow you to set 
the partner network name. Remember, the fully-qualified partner name is 
?7LOCALNET?.2?PARTNERLU? (for example, USNET1.PARTNER). 


3. Protocol must be entered and must be APPC. 


4. SInglesess must be set to NO. The example definitions in this guide all require 
parallel sessions. 


5. The “+” sign indicates the bottom of the first screen displayed by CEDA. The 
function key settings are displayed at the bottom of the screen (but not shown 
here). 


6. Attachsec specifies the type of secunty that can be used. Persistent means that 
this partner sends a user-ID and password the first time it tnes to start a trans- 
action; subsequent transactions are sent with just the user-[D and some bits that 
say “persistent verification - already signed on.” CICS V3R3 will keep a table of 
logged-on users. The partner system can still try to start a program with no 
security and if the transaction does not require security, it will run. However, 
transactions that require RACF user-ID authonzation would fail in such cases. 


Here the default, “Local,” means that any transaction that can be run by the 
default user-[D, CICSUSER, can be run by this partner LU. 
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9.9.4.2 Defining SESSIONS 


To define the mode name and session characteristics for the partner LU a SES- 
SIONS definition must be created. The following command builds a 3270 screen 
that allows you to do so. 


ceda define group(?GROUP?) sessions (?SESSION?) 
Figure 36 shows the 3270 screen that you should as a result. 


OVERTYPE TO HODIFY : CICS RELEASE = 0330 
CEDA DE€Fine 
Sessions : ?SESSIOH? # note 1 
Group : 2GROUP? 
DEscription ==> ?MODE? SESSIONS FOR PARTNER LU 
SESSION IDENTIFIERS 
Connection 2CON? . # note 2 
SESSName 
NETnameq 
HOdename 2 2 | # note 3 
SESSION PROPER 
Protocol Appc | Lu61 
MAx imum 0-999 # note 4 
RECEIVEPfx 
RECEIVECount 1-999 
SENDPFx 
SENDCount 1-999 
SENDSize > 04096 | 1-30720 
RECEIVESize > 04096 1-30720 


~ APPLID=TOCICS3 


Figure 36. CEDA DEFINE GROUP?GROUP?) SESSIONS 


Required parameters: 


|. Sessions is the CICS name for this session set. The name must be unique 
within this group. 


2. Connection identifies the CICS connection in this group (in other words, the 
partner LU) associated with this mode name. 


3. ‘\odename specifies the mode for this group of sessions. 


4. Maximum specifies the number of sessions for this mode name. The values 
shown here match the default values for the mode names #INTER and 
#BATCH as defined in APPN end nodes and network nodes. 


5.5.4.3 Define transaction program - server 
To define a transaction program in CICS requires two things, a TRANSACTION 
and a PROGRAM. The TRANSACTION definition assigns the unique four- 
character transaction identifier for this CICS region, while the PROGRAM estab- 
lishes characteristics of the executable code. The examples here show the server side 
of APING, namely APINGD. 


To define the APINGD program, type the following command: 
ceda define group(?GROUP?) program 


You should see the screen shown in Figure 37 on page 65. 
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OVERTYPE TO MODIFY CICS RELEASE = 0330 
CEDA DEFine 
PROGram : 2SERVERPGM? # note l 
Group : 2GROUP? 
DEscription TEST PROGRAN TO ALLOCATE AND DEALLOCATE 
Language C CObol | Assembler | Le370 | C | Pli # note 2 
| Rpg 
No No | Yes 
No No | Yes 
Norma] Normal | Transient 
USE] pacopy No No | Yes 
Status Enabled Enabled | Disabled 
RS] : 80 0-24 | Public 
Cedf ==> Yes Yes | No 
DAtalocation ==> Below Below | Any 
EXECKey ==> User User | Cics 
REMOTE ATTRIBUTES 
RENOTESystem ==> 
+ REHMOTEName ==> 


RELoad 
RESident 
USAge 


Vv 


|] | | en | oo 
io ob tf ot o& 


Vv 
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Figure 37. CEDA DEFINE GROUP?GROUP?) PROGRAM 


Required parameters: 


1. Program is the name of the member of 7APINGLIB? that contains the 
APINGD executable code. (See Figure 29 on page 58 for the JCL to include 
this load library in CICS’ search list.) 


ba 


. Language specifies the source language of the program. The APINGD sample 
program 1s wnitten in C, so the default, Cobol, must be changed. There is a 
Cobol version of APINGD that will run on CICS systems that do not have 
CPI-C support (such as CICS Version 2 Release 1.2) or that do not have the C 
run-time libranes. The Cobol source code is available on CompuScrve, the 
IBM BBS, and MK TTOOLS. 


To define the transaction, type the following command: 


ceda define group(?GROUP?) transaction 


The resulting screen should resemble that shown in Figure 38. 


OVERTYPE TO MODIFY CICS RELEASE = 0330 
CEDA OEFine 
TRansaction : 2SERVERTRAH? # note 1 
Group : 2GROUP? 
DEscription APING SERVER TRANSACTION 
PROGram 2SERVERPGN? # note 2 
TWasize 00000 0-32767 
PROFile DFHCICST 
PArtitionset 


vv 


Vv 


non now on 
a | | 
Vv 


ALIASES 
Alias 
TASKReq 
XTRanid : 
+ TPName : APINGD # note 3 


APPLID=TOCICS3 


Figure 38. CEDA DEFINE GROUP?GROUP?) TRANSACTION 
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Required parameters: 


1. Transaction is the one-to-four character transaction id. The APING client spec- 
ifies a remote TP name of APINGD (as a default). When CICS receives a 
request to start a transaction, it only looks at the first four characters of the TP 
name. Therefore APING must be the transaction id used by this program. 


2. Program is a pointer to the PROGRAM definition. In this case the 
PROGRAM definition has the same name as the program. 


3. The TPName parameter is not supported in CICS/MVS Version 2, 


The other values shown in this example are local system defaults. 


9.9.4.4 INSTALLing the Definitions 


Before any definitions can be used they must be added to the running CICS System 
Definition (CSD) using the INSTALL command. This is accomplished by typing 


CEDA INSTALL GROUP(?GROUP?) 


T his command will install all the objects in the group - CONNECTIONS, SES- 
SIONS, PROGRAMS, etc. Some objects can be installed individually, too. Here 
is an example of installing a change to the program APING: 


CEDA INSTALL GROUP(?GROUP?) PROGRAM (APING) 


If a resource is in use, or /n Service in CICS terms, the installation will fail. If you 


. get the INSTALLATION FAILED message, you can display the messages by 


pressing the PF9 key. This shouldn't happen the first tume, though. | 


If you need to take a CONNECTION out of service, or disable a TRANSACTION 
or PROGRAM, use the CEMT transaction (see 5.4, “Working with CICS and 
VTAM” on page 55). 


9.5.5 Configure to run as a client 


Only the client has to deal with CPI-C side information and CICS provides a 
default entry that allows programs to use CPI-C with no predefined side informa- 
tion. APING wiul accept a fully-qualified partner LU name 
(?7LOCALNET?.27PARTNERLU?) as the partner LU parameter. Therefore, ihe fol- 
lowing two definitions are not necessary if the connection and sessions definitions 
follow the guidelines stated above. 


The PARTNER definition contains most of the details, but the default profile uses 
a blank mode name. The PROFILE definition uses the #INTER mode name. 


5.5.9.1 Define CPI-C Side Information (OPTIONAL) 
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To define CPI-C side information in CICS you must create a PARTNER definition 
and a PROFILE definition. Both are optional. You can invoke APING with 
either the CICS netname (7PARTNERLU?) or a fully-qualified partner LU name 
(?LOCALNET?.2?PARTNERLU?) and APING will work properly. 


To create a PARTNER definition, type the following command in CICS: 


ceda define group(?GROUP?) partner 


The 3270 screen shown in Figure 39 on page 67 should appear. Type in the values 
for Partner, Netname, Network, and TP name from the worksheet in 5.3, “CICS 
Configuration Worksheet” on page 52. 
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OVERTYPE TO MODIFY CICS RELEASE = 03390 

CEDA DEFine 
PARTNer : 2SYHDEST? note 1 
Group : 2GROUP? 
Description ==> CPI-C SIDE INFO 

REMOTE LU NAME 
NETName == 
NETWork ==> 
SESSION PROPERTIES 
Profile ==> DFHCICSA note 3 
REMOTE TP NAME 
Tpname 


> 2PARTNERLU? note 2 
?PARTHERNET ? # note 2 


> 2?TPNANE? # note 4 


viv 


Xtpname 


Vv 


Vv 


APPLID=TOCICS3 


Figure 39. CEDA DEFINE GROUP?GROUP?) PARTNER. The CPI-C side informa- 
tion. 
Required parameters: 
1. Partner is the name for this resource in CICS. 
2. Netname is the partner’s LU name. Network is the partner’s network name. 


3. Profile 1s the set of characteristics this partner has. The most important of these 
is the modename. The default profile, DFIICICA, works if the program sets 
the mode name explicitly. APING does set the mode name to #INTER as the 
default. 


4. Tpname is the initial setting for the remote TP name. This can be overndden in 
the program using Set_TP_ Name (CMSTPN). The TP name must match a 
corresponding TP definition at the remote system. 


To define a PROFILE to explicitly set the mode name for the CPI-C side informa- 
tion, type the following command: 
ceda define group(?GROUP?) profile 


The screen shown in Figure 40 on page 68 should appear. Type in the values for 
?PROFILE? and ?MODE? from the worksheet in 5.3, “CICS Configuration 
Worksheet” on page 52. | 
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OVERTYPE TO HODIFY 
CEDA DEFine 
PROFile 
Group 
DEscription 
Scrnsize 
Uctran 
HOdename 
PRIntercomp 
JOURNALL ING 
Journal 
HSGJrnl 
PROTECTION 
HSGInteg 
Onewte 
PROtect 
Chaincontrol 
PROTOCOLS 
+ DVsuprt 


Vv 


Vv 


uooronw 
en ee 
Vv 


i 
“os. 
Vv 


CICS RELEASE = 0330 


: 2PROFILE? 
: 2GROUP? 


CPI-C PROFILE TO CHANGE MODE NAHE 
Default Default | Alternate 
No No | Yes 
2HODE? 

| Yes 


1-99 
INPut | Output | INQut 


Yes 
Yes 
Yes 
Yes 


All | Nonvtam | Vtam 


APPLID=TOCICS3 


Figure 40. CEDA DEFINE GROUP?GROUP?) PROFILE 


Required parameters: 


1. Profile is the name for this resource. 


eter in the PARTNER definition. 


# note 1 


# note 2 


This name must match the Profile param- 


2. lode name identifies the mode for this side info entry. There must be a SES- 
SIONS definition with the same modename. (Remember, this profile entry is 
optional if the application uses a default mode name, as APING does.) We 
recommend that 7MODE? be #INTER or one of the other mode names that 


ship with APPN products - #BATCH, 


2: 9.5.2 Define transaction program - client 
Defining the client TRANSACTION and PROGRAM 1s just like defining the 

server as described in 5.5.4.3, “Define transaction program - server” on page 64. To 
define the PROGRAM, type the following in CICS: 


ceda define group(?GROUP?) program 
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You should get the screen shown in Figure 41 on page 69. 


Multi-Platform Config 


#INTERSC, or #BATCHSC. 


OVERTYPE TO MODIFY CICS RELEASE = 0330 
CEDA OEFine 
PROGram : 2CLIENTPGM? # note l 
Group : 2GROUP? 
DEscription APING CLIENT PROGRAM 
Language C CObol | Assembler | Le370 | C | Pli # note 2 
_ [| Rpg 
RELoad No No | Yes 
RESident No No | Yes 
USAge Norma] Normal | Transient 
USE] pacopy No No | Yes 
Status Enabled Enabled | Disabled 
RS] : 00 @-24 | Public 
Cedf Yes Yes | No 
DAtalocation Below Below | Any 
EXECKey User User | Cics 
REHOTE ATTRIBUTES 
REHOTESystem ==> 
REHOTEName 
Transid 
EXECUtionset Fullapi Fullapi [| Dplsubset 


APPLID=TOCICS3 


Figure 41. CEDA DEFINE GROUP?GROUP?) PROGRANI. Here you tell CICS about 
the executable program. 


Required parameters: 


1. Program is a member of the MVS load library 7APINGLIB? included in the 
DFHRPL DD concatenation list in the CICS start-up procedure. (See 
Figure 29 on page 58.) 


2. Language must be set to C. 
To define the TRANSACTION, type the following in CICS: 
ceda define group(?GROUP?) transaction 


You should get the screen shown in Figure 42. Modify the Transaction and 
Program fields as descnbed in the notes. 


OVERTYPE TO HODIFY CICS RELEASE = 0330 

CEDA DEFine 
TRansaction >: 2CLIENTTRAH? # note lL 
Group : 2GROUP? 
Description APING CLIENT TRANSACTION 
PROGram 2CLIENT PROG? # note 2 
TWasize 00000 0-32767 
PROFile OFHCICST 
PArtitionset 
STatus Enabled Enabled | Disabled 
PRIMedsize : 00000 0-65520 
TASKDATALoc ==> Below BeTow | Any 
TASKDATAKey ==> User User | Cics 

REHOTE ATTRIBUTES 
DYnamic ==> No No | Yes 
REHOTESystem ==> 
REHOTEName ==> 
TRProf 


Vv 


| 
mow ot ou 
Vv 


Vv 


tt 


No | Yes 
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Figure 42. CEDA DEFINE GROUP?GROUP?) TRANSACTION 
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Required parameters: 


1. Transaction is the four-character transaction id. This must be unique in this 
CICS region. As this transaction is started by a local terminal user, it does not 
need to match anything specified at the remote system. 


2. Program is a pointer to the PROGRAM object defined in Figure 41 


Remember to CEDA INSTALL your new definitions! (See 5.5.4.4, EEE 
the Definitions” on page 66.) 


9.6 Running APING 


To run APING, type any of the following commands at a clear CICS screen (don’t | 
forget the period if you use the first format): 


2CLIENTTRAN? -n 2PARTNERNET?.2?PARTNERLU? 
2CLIENTTRAN? -n 2?PARTNERLU? 
2CLIENTTRAN? -n 2SYMDEST? 


You should see the APING logo and output. The “-n” switch tries to start the 
APINGD transaction on the remote computer without any security information 
(user-ID and password). 


Note: If you are running with RACF, your transaction must be authorized and 
your user-ID must be authonzed to use it. If you get an error message like 
“DFHAC2033 ... Your are not authonzed to use transaction NX XX.” you will need 
to contact your RACF administrator. 


You may need to manually start a session between CICS and the partner LU, since 
CICS does not do this automatically. To start a session with the partner session, at 
a CICS screen type this command: 


cemt ing con(?CON?) 


You will get the screen shown in Figure 43. By the connection and netname for 
the partner LU you should see “Ins Acq.” This is CICS short-hand for “In- 
service, acquired.” If the status 1s “Ins Rel,” overtype the “Rel” with “Acq” and 
press the enter key. The resulting screen should now have “Ins Acq”’ as the status. 
If not, contact your VTAM systems programmer and make sure that the partner 
LU 1s active. You can also use the commands descnibed in 5.4.2, “Other 
commands” on page 56 to display or activate the partner LU or switched major 
node. 


INQ CON(?CON?) 


STATUS: RESULTS - OVERTYPE TO HODIFY 
Con(2CON?) Net (PARTNERLU?) Ins Rel NORHAL 


Figure 43. CICS Status for Connection 7?CON? 
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5.7 How to find... 
« LU Name 


If you can logon to the CICS region to begin defining partners, the CICS LU 
name appears on the bottom nght of the screen as APPLID = 7LOCALLU?. 
Here that’s TOCICS3. 


© Control Point (CP) Name 


In MVS systems, the CP name is equivalent to the name of the VTAM System 
Services Control Point (SSCP). It takes its value from the SSCPNAME param- 
eter in ATCSTRxx (see Figure 44). 


e Network Name 


The network name can be found in the VTAM start list member of 
SYSIL.VTAMLST. Look for a member named ATCSTRxx, where xx ts 00 or 
TS or something. It should look like this: 


HOSTSA=1, X 
SSCPID=01, X 
SSCPNAME=?LOCALCP?, X 
DYNASSCP=NO, X 
NETID=2?LOCALNET?, | X 
MAXSUBA=63, X 
CONF IG=00, X 
NOPROMPT , X 
etc. 


Figure 44. The VTAM Start Parameter List - SYS]. VTAMLST(ATCSTROO) 


¢ LAN Address 


The LAN address for a CICS host connected to a token nng through a 3745, 
3720, or 3725 is in the NCP gen in SYS].VTAMLST. Look fora GROUP 
macro statement with ECLTYPE= PHYSICAL and immediately after that 
should be a LINE macro with a LOCADD parameter. That is the LAN 
address. Here is an example: 


* BUILDING RING DEFINITIONS (PHYSICAL) 


TO30T2PG GROUP ECLTYPE=(PHYSICAL,ANY), = 
TYPE=NCP, > 
etc. 

TO30T2PL LINE ADDRESS=(1089, FULL) , LOCADD=? LANADDRESS? , PORTADD=2, = 
RCVBUFC=4095 , MAXTSL=692 ,ADAPTER=TIC2, TRSPEED=4, = 


UACB=(XSP2AX , XSPZAR) 
Figure 45. Portion of NCP Gen with LAN Address 
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6.0 Networking Services/DOS Configuration 


Networking Services/DOS 1s a software product that supports the CPI-C interface 
APPC in the DOS and Microsoft Windows 3.0 and 3.1 environments. Networking 
Services/DOS allows a DOS machine to participate as a low entry networking node 
(see 1.9, “What Is APPN?” on page 6 for a discussion of node types). This chapter 
describes how to configure Networking Services/DOS running on DOS 3.3 or later 
on a workstation with a token-nng adapter connecting it to a token ring local area 
network. 


6.1.1 Prerequisites 
¢ Networking Services/DOS, Version 1.0, Part number 20G0437 


¢ DOS, Version 3.3 or greater 


¢ Local Area Network Support Program, Version 1.3 (Supplied with Networking 
Services/DOS) 


¢« Token nng adapter 


For additional configuration information, refer to the Networking Services} DOS 


User's Guide and Reference, S20G-0438-00 


6.2 Terminology 


The terminology table maps the standard networking terms defined in 1.10, “How 
do I Configure a Network?” on page 7 to the terms used by Networking 


Services/DOS. 
Networking Services] DOS Term 
network ID or NETID 
local LU name 


adapter address 


remote computer LAN address 


6.3 Networking Services/DOS Configuration Worksheet 


Use the following worksheet to-determine all the values you will need to configure 
this platform. The worksheet is split into two parts: values determined by refernng 
to the Guide introduction or other platform chapters, and values that are local to 
this platform which you create. There are three columns. The left-most column 
has a variable name that starts and ends with a question mark (?), the middle 
column describes what the variable is used for and how to determine its value, and 
the night-most column is left blank so you can fill in a value. Whenever there 1s a 
reference in this chapter to a value in the left column, substitute the value you have 
wnitten in the nght column. 
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For example, if you are following the recommendations in the Worksheet, you will 
write #/NTER in the nght column on the 7MODE? line. Then in Figure 48 on 
page 78 you will type #INTER on the line to replace “MODE like this: 


7SYMDEST? ?PARTNERNET?.2PARTNERLU? #INTER 2TPNAME? 


Likewise, the other symbols on the line above will be replaced with the appropniate 
values from the nght column of the Configuration Worksheet. 


Symbol How to determine the value for this symbol Fill in value 
: : here | 


Values that must match with other places 


?7LOCALLU? 


This is the LU name of the machine you are defining to the 
network. Refer to 1.10, “How do I Configure a Network?” on 
page 7 for information on how to define this value. 


27LOCALNET? This is the network name of the machine you are defining to the 
network. Refer to 1.10, “How do I Configure a Network?” on 


page 7 for information on how to define this value. 


27PARTNERLU? This is the partner’s LU name. Refer to the “How to find...” 
section of the partner computer’s configuration chapter for this 


value. 


This is the network name of the partner computer. Use the 
network name from the partner computer’s “How to find...” 
section. | 


?PARTNERNET? 


?7LANADDRESS? 


This is the LAN Address of the partner computer. (Or the LAN 
Address of a network node, if the link 1s being made to a 
network node.) Refer to the “How to find...” section of the 
partner computer’s configuration chapter for this value. 


7TPNAME? This is the name of the transaction program at the partner com- 
puter. It is a name that is sent across the network to the server 
machine. The server machine then maps this TP Name to an 
executable program. The TP Name is usually specified in a 
client/server product’s documentation. For APING, the TP 


Name on the server 1s APINGD. 


IMODE? 


See 1.6, “What Is a Mode?” on page 5 for a discussion of 
modes. Often, a client/server product’s documentation specifies 
what mode must be used by that product. APING can use any 
mode (this can be specified on the APING command line), but 
the default is #INTER. It is recommended that you use one of 
the architected modes discussed in the “What Is a Mode?” 
section. 


Local values 


2LINK NAME? 1 to 8 letters or numbers which will be used as a local name on 
| the Networking Services/DOS machine to refer to the link to a 
partner computer. Suggestion: LINK0001 
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Symbol How to determine the value for this symbol Fill in value 
here 
2S YMDEST? This is the CPI-C side information symbolic destination name. 
It is any 1-8 character name you choose. It will be used locally 
on the Networking Services/DOS machine to refer to a CPI-C 
side information entry. Suggestion: use the same value as 
2?LOCALLU?. | 
YT PPATH? This is the fully-specified path and filename of the executable 


code for a server transaction program located on your machine. 
6.4 Working with Networking Services/DOS 


For example, if Networking Services/DOS is installed on the C:\ 
drive, this value could be: 
C:\NSD\SAMPLES\APING\APINGD.EXE 


6.4.1 Starting/stopping APPC 
Once your Networking Services/DOS configuration files are set up, you start Net- 
working Services/DOS by issuing this command: 


NSD START CONFIG.NSD 


You can stop Networking Services/DOS and unload it from memory by issuing the 
command 7 


NSD STOP /U 


6.4.2 Displaying active sessions 
You can display active APPC sessions by issuing the command: 


NSD LIST /SESSION 


This command may be useful in determining where an error may be occurmning if 
APING does not run successfully. 


6.4.3 Other commands i 
The other NS/DOS commands are documented in the Networking Services/ DOS 
User's Guide and Reference. 


6.5 Configuration 


The following configuration steps will be discussed: 
1. Define yourself to the network 
2. Define a link to a partner or intermediate node 
a. Additional LEN configuration 
b. Other link configuration 
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3. Configure to run as a client 
a. Define CPI-C side information 
b. Other client configuration 

4. Configure to run as a server 
a. Define transaction programs 


b. Other server configuration 


6.5.1 Working with APPC configuration 
Networking Services/DOS configuration is done through configuration files that are 
loaded and interpreted when an NSD START command is issued. These files are: 


» CONFIG.NSD 
- SIDEINFO.NSD 
» DEFINETP.NSD 
» MODE.NSD 


All these files need to be in the same directory. When Networking Services/DOS is 
started, it searches for these files in the current directory. To get Networking 
Services/DOS up and running from the .NSD files supplied with NS/DOS (in the 
\NSD\EXAMPLES subdirectory), you only need to alter the CONFIG.NSD and 
DEFINETP.NSD files. 


6.5.2 Define yourself to the network | 
Before an Networking Services/DOS machine can communicate on a network, it 
must define itself to the network. This is done with an NSDN statement in the 
Networking Services/ DOS’s CONFIG.NSD file. The NSDN statement specifies the 
fully-qualified LU name of the DOS machine. 


Networking Services/DOS provides many sample configuration files in the 
\NSD\EXAMPLES directory. To use the token-mng example as your base config- 
uration file, copy TKRING.NSD from the \NSD\EXAMPLES directory to 
\NSD\CONFIG.NSD. Then, throughout this chapter, make changes to this 
CONFIG.NSD as indicated in the examples. 


NSDN ?LOCALNET?.?LOCALLU? 
Figure 46. Define yourself to the network - (in CONFIG.NSD) 


6.5.3 Additional common configuration 
There are several more statements that can be added to your CONFIG.NSD to 
improve performance or to specify more detailed information about how Net- 
working Services/DOS runs in your machine. See the Networking Services) DOS 
User's Guide and Reference to learn more about them. Here we will discuss just 
two of these statements that you may have to configure to get Networking 
Services/DOS to run. These statements control access to resources within your 
machine that may already be used by something else. 


The NSDI statement controls which DOS interrupt Networking Services/DOS will 


clam. You only need to use this statement if there are problems running the NSD 
START command. The default interrupt is 0x68. If you receive an error message 
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when running the NSD START command that indicates that an interrupt 1s already 
in use, change (or add) the following line in your CONFIG.NSD, specifying a dif- 
ferent interrupt number: 


NSDI 68 /* valid values are 60 through 68 */ 


Another problem you may encounter, due to possible conflicts with other software 
running on your machine, is a conflict in which SAP (service access point) Net- 
working Services/DOS uses when it opens the LAN adapter. The default value is 
04. If you receive an error message when running the NSD START command that 
indicates there is a SAP conflict, add the following line to your CONFIG.NSD, 
specifying a different SAP: 


TRSS 64 /* valid values are X'04' through X'FC' and must be */ 
/* divisible by 4. X'O8' is recommended as a a 6 
/* second choice. Then try 'OC', '10', '14', '18'...*/ 


Note: The SAP you use must also be within the partner computer’s valid range, so 
try to use as small a value as possible, such as 08 or OC. 


6.5.4 Define a link to a partner or network node 
In order to start a conversation with another node, you must define a link to that 
node, or a link to a network node. 


If you choose to define multiple links, you may also need to execute a command 
that tells Networking Services/DOS which link to use to find a particular partner 
LU. 


6.5.4.1 Defining a link 
A link is defined with the TRLD statement: 


TRLD 2LINKNAHE?, 2?LANADDRESS? 
Figure 47. Define a link - Gn CONFIG.NSD). 


6.5.4.2 Other link configuration | 
You can define more than one link by including more than one TRLD statement in 
your CONFIG.NSD file. When an APPC program attempts to establish a conver- 
sation with another node, Networking Services/DOS has to determine which link to 
route APPC traffic on. Networking Services/DOS will first search to see if a link 
has been assigned to the partner LU by a previous session activation. If so, that 
link is used; if not, Networking Services/DOS will send the request to find the - 
partner LU to the first link specified in your CONFIG.NSD. If the partner LU is 
to be located through a different link, you must, in addition to defining the link with 
a TRLD statement, specify through which link the LU should be found. To do 
this, you must run the NSD ACTIVATE command after starting Networking 
Services/DOS with NSD START. The NSD ACTIVATE command looks like 
this: 
NSD ACTIVATE LU=?PARTNERNET?2.?PARTNERLU? LINK=?LINKNAME? 
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6.5.5 Configure to run as a client 


6.5.5.1 Define CPI-C side information 


Some applications, like APING, do not require CPI-C side information to run. 
These applications use programming calls available on a particular platform to 
dynamically create side information when running. Networking Services/DOS pro- 
vides the programming calls that allow APING (and other applications) to do this, 
so for APING, you do not need to create this Side Information profile. For those 
applications that require CPI-C Side Information, this is how to create a profile: 


CPI-C side information is defined in the SIDEINFO.NSD file. To add a CPI-C 
side information entry, edit this file and add a line specifying the Symbolic Destina- 
tion Name, Partner LU Name, Mode Name, and Transaction Program Name as 


_ follows: 


2SYMDEST2? 2PARTNERNET?.?PARTNERLU? ?HMODE? ?TPNAME? 
Figure 48. Define CPI-C side information - Gn SIDEINFO.NSD) 


6.5.6 Configuring to run as a server 


6.5.6.1 Define transaction programs 


To run Networking Services/DOS as a server, you must, in addition to the common 
configuration steps above, define a transaction program (TP) on your machine that 
will be started when the client establishes the conversation. The TP is defined in 
the DEFINETP.NSD configuration file. Here is the syntax of this statement in 
DEFINETP.NSD: 


?7TPNAME? ?TPPATH? * * OPERATOR STARTED 


Figure 49. Define a transaction program - (in DEFINETP.NSD). The asterisks indicate 
that you want to accept the default timeout values when starting the transaction 
program. 


The last value on the line specifies the “TP program operation”. This parameter 
indicates how the TP is started. It can be one of the following: 


AM_STARTED 
the Program Launcher starts the program. The Program Launcher 
operates only in the Microsoft(TM) Windows environment. 


OPERATOR_STARTED 
the Networking Services/DOS user starts the program. If you are not 
running in the Microsoft Windows environment, this 1s your only 
option. (Actually, if you’re not running in the Microsoft Windows envi- 


ronment, the TP program operation parameter is ignored because 
OPERATOR_ STARTED is the only valid operation). 


6.5.7 Running APINGD 
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After running NSD START with the updated information in DEFINETP.NSD, 
you should be able to APING the Networking Services/DOS machine from another 
machine. If you are using the Program Launcher in the Microsoft Windows 
einvironment, you must start the Program Launcher before starting APING on the 
partner machine. To start the Program Launcher, double-click an icon created from 
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the \NSD\NSDPLW.EXE file, or place this icon in the startup folder to have the 
program launcher started whenever Windows is started. 


If you are not using the Program Launcher, you will have to manually start 
APINGD.EXE on the Networking Services/DOS machine. This can be done before 
or after you start APING on the partner machine. 


6.6 Running APING 


You should now be able to APING any of the computers you configured to using 
the steps above. 


To run APING, issue this command: 
APING -n ?SYMDEST? 


or you can specify the fully-qualified LU name of your partner: 
APING -n 2?PARTNERNET?. ?PARTNERLU? 


If Networking Services/DOS should try to locate the partner machine on a link 
other than the first one specified in your CONFIG.NSD, you need to run the “NSD 
ACTIVATE” command after starting Networking Services/DOS, and before 
APINGing that partner machine. For example: 


NSD ACTIVATE LU=? PARTNERLU?. ?PARTNERNET? LINK=?LINKNAME? 


6./ How to find... 


¢ LU name 


The LU name 1s specified in the CONFIG.NSD file on the NSDN line. The 
LU name consists of the entire string following the penod. 


e Network Name 


The network name is specified in CONFIG.NSD on the NSDN line. The 
network name is the 1-8 characters preceding the period. See 6.5.2, “Define 
yourself to the network” on page 76 for details on the syntax of the NSDN 
Statement. 


¢ Control Point (CP) name 
The CP name is the same as the LU name. 
¢ LAN address 


The LAN address is a 12-digit hexadecimal value that identifies your token-ring 
adapter to the network. There is a LAN address hard-coded on the Token- 
Ring adapter in the Networking Services/DOS machine. This hard-coded value 
is sometimes be over-ndden with something called a “locally administered 
address.” You can find the LAN address on your Token-Ring card by running 
the program LANADDR, which is supplied with Networking Services/DOS. 
When you run LANADDR, the LAN address of your machine will be dis- 
played as the “Adapter 0 in-use address”.. Use the 12 hexadecimal digits dis- 
played. (If you have a secondary adapter installed and are accessing it with the 
Networking Services/DOS optional keyword TRAN, you would use the 
“Adapter | in-use address”.) The “in-use address” displays the “locally adminis- 
tered address” if there is one being used. 
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7.0 APPC/MVS Configuration 


This chapter describes how to configure APPC/MVS. The configuration is spread 

among the APPC/MVS subsystem, VTAM, and NCP. Examples of configuration 
of each are shown. The filenames shown are sample files created for VTAM, NCP, 
and APPC/MVS. 


7.1.1 Prerequisites 
Software and hardware prerequisites for APPC/MVS include: 


¢ MVS/ESA V4.2 or later 

¢ VTAM V3.3 or later 

¢ NCP V5.2 or later 

¢ 3745 with Token-nng attachment 

e Using the transaction program(TP) APING as a sample TP 
¢ Single SNA domain. 


While the 3745 is not a strict prerequisite (a 3172, for example, can be used instead) 
this document only descnbes configuration with a 3745 as gateway. 


7.1.2 Prerequisites | 
For more detailed information on APPC/MVS configuration and operation refer to: 


¢ MVS/ESA Planning: APPC Management, GC28-1110 

¢ VTAM Resource Definition Reference, SC31-6438 

¢ NCP Resource Definition Reference, SC30-3448 

¢ APPC/MVS Handbook for OS/2 System Administrator, GC28-1133 
¢ APPC Sys Defs in MVS/ESA and OS/2, GG66-3224 


7.2 Terminology 


The terminology table maps the standard networking terms defined in 1.10, “How . 
do I Configure a Network?” on page 7 to the terms used by APPC/MVS. 


APPC/MVS Term ; 
Network Name NETID 


LU Name | name supplied for APPL definition in 
APPL major node 

Partner LU Name name supplied for LU definition in 
major nodes other than APPL 


LOCADD (in NCP gen) 


DIALNO (on PATH definition in 
switched major node) 
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7.3. APPC/MVS Configuration Worksheet 


Use the following worksheet to determine all the values you will need to configure 
this platform. The worksheet is split into two parts: values determined by referring 
to the Guide introduction or other platform chapters, and values that are local to 
this platform which you create. There are three columns. The left-most column. 
has a variable name that starts and ends with a question mark (7), the middle 
column describes what the variable 1s used for and how to determine its value, and 
the nght-most column is left blank so you can fill in a value. Whenever there is a 
reference in this chapter to a value in the left column, substitute the value you have 
written in the nght column. 7 


Symbol How to determine this value 
here 


Values that much match with other places 


?2?LOCALLU? This is the symbol that refers to the LU name of the machine = 


you are defining to the network. 1 to 8 character field con- 
sisting of alphanumeric characters which is the LU name of the 
node. Choose a name that is unique within the same network 
name. Refer to 1.10, “How do I Configure a Network?” on 
page 7 for more information about LU names. 


The value specified for the ACBNAME on the LUADD state- 
ment in the PARMLIB member APPCPMxx defines an 
APPC/MVS LU. Look in this PARMLIB member to see if 
one has already been created. 


?7LOCALCP? This is the symbol that refers to the Control Point name of 
your machine. Refer to 1.9, “What Is APPN?” on page 6 for 


more information about control points. 


VTAM, being a LEN node, does not have a CP (Control 
Point) name for APPN use. It does, however, have an 
SSCPNAME (System Services Control Point Name). Use the 
SSCPNAME in lieu of a CP name. It is the value specified for 
SSCPNAME in the VTAM start options member 
(ATCSTRxx is the start options member of the VTAMLST 
dataset). 


?7LOCALNET? This is the symbol that refers to the network name of the 
machine you are defining to the network. 1 to 8 character field 
consisting of alphanumeric characters. There is a structured 
format for the network name which includes the country code, 
enterprise code and network suffix code. This format insures 
uniqueness around the world. Call your local IBM branch 
office for the format information and to register your network 
name. Refer to 1.10, “IHfow do I Configure a Network?” on 


page 7 for more information about network names. 


For systems with VTAM already configured, this value is 
found in the VTAMLST start options (ATCSTRxx) member. 
The option name is NETID. 


This is the partner’s LU name. Refer to the “How to find...” 
section of the partner computer’s configuration chapter for this 
value. 


?PARTNERLU? 
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Symbol How to determine this value Fill in value 
here 


27LANADDRESS? This is the LAN Address of the partner computer. (Or the 
LAN Address of a network node, if the link is being made to a 
network node.) Refer to the “How to find...” section of the 
partner computer's configuration chapter for this value. Refer 
to 1.10, “How do I Configure a Network?” on page 7 for more 
information about the partner network name. 


7TPNAME? This is the symbol for the Transaction Program name. This is 
the name of the transaction program at the partner computer. 


For APING, the TP Name on the server is APINGD. 


This is the symbol for the mode name. See 1.6, “What Is a 
Mode?” on page 5 for a discussion of modes. Often, a 
client/server product’s documentation specifies what mode 
must be used by that product. APING can use any mode (this 
can be specified on the APING command line), but the default 
is #HINTER. It is recommended that you use one of the archi- 
tected modes discussed in the “What Is a Mode?” section. 


Local values 


?INCPLANADDR? 


This is the local LAN address coded in NCP on a LINE 
macro using the LOCADD parameter. 


2MODETAB? Name of a logon mode table in VTAM. It is assembled and 
link-edited into a VWTAM LOADLIB dataset. The systems pro- 
grammer should know the names of the logon mode tables 
defined on the system. This should be the name of the table 


where the APPC modes are included. 


This is symbol for the CPI-C side information symbolic desti- 
nation name. It 1s any 1-8 character name you choose. It is 
included when creating a side information entry. Its value 
matches that provided on the DESTNAME parameter of the 
side information entry.’ parameter. 


2S YMDEST? 
This is the symbol for the name of a volume on which VSAM 
datasets for APPC/MYVS will be created. It is a maximum of 


?VOL? 
six Characters. 

2JES? The actual JES subsystem type (JES2 or JES3) should be sub- 
stituted for this. 

2CLIST.DATASET? | The CLIST dataset in which you put the transaction 
program(APINGD) CLIST . 

2?APPC.LOADLIB? The load library dataset in which you put the transaction 
program(APING). 


?STFILE? This is the symbol for the VSAM dataset where CPI-C Side 


Information profiles will be permanently located. This value 1s 
?TPFILE? 


normally SYS1I.APPCSI 


This is the symbol for the VSAM dataset where TP profiles 
will be permanently located. This value is normally 
SYS1.APPCTP 
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Symbol How to determine this value Fill in value 
here 


7TPLEVEL? This is the symbol for specification of where to begin searching 


for TP profiles. USER provides the search order: USER pro- 
vides the search order. You may also specify GROUP (USER 
profiles ignored) or SSYTEM (USER and GROUP profiles 
ignored) 


7.4 Working with APPC/MVS 


7.4.1 Starting/stopping APPC | 
The commands to start APPC/MVS are: 


START APPC,SUB=MSTR,APPC=xx 
START ASCH, SUB=MSTR , ASCH=xx 


The xx 1s the identifier of the parmlib member. The default is 00. 


APPC/MVS is ended by issuing: 


C APPC 
C ASCH 


7.4.2 Other commands 
Once APPC/MVS is activated, there are several commands that can be used to 
monitor APPC/MVS operation. A subset of these commands is shown below: 


DISPLAY APPC,TP,ALL 
DISPLAY APPC,LU,ALL 
DISPLAY ASCH,ALL 


These commands provide information on APPC/MVS TPs, LUs, and scheduler 
operations, respectively. 
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7.5 Configuration 


7.5.1. Working with APPC configuration 


The following configuration steps will be discussed: 
1. Define yourself to the network 
2. Define a link to a partner or intermediate node 
a. Additional LEN configuration 
b. Other link configuration 
3. Configure to run as a client 
a. Define CPI-C side information 
b. Other client configuration 
4. Configure to run as a server 
a. Define transaction programs 


b. Other server configuration 


For APPC/MVS, configuration is done in the following places: 


¢ SYS].PARMLIB - Two parmlib members are added with parameters for the 
APPC and ASCH subsystems, respectively. 


« VSAM - Datasets are needed for TP definitions and CPI-C side information. 


e VTAM - Definitions are required in an application major node for the 
APPC/MVS LU or LUs, as well as partner definitions in a switched major node 
for LAN attached nodes, such as workstations. Additions are also need in logon 
mode tables for APPC modes. 


e NCP - The token-nng adapter must be configured, and a parameter added to 
the NCP definition to support reserve storage for APPC LUs. 


7.5.2 Define yourself to the network 
1. Create Parmlib members 


The samples below show placement of two members (ASCHPMO0 and 
APPCPMO00) in SYS!.PARMLIB. These two members have startup parameters 
for the two applications that make up APPC/MVS; APPC, the base APPC” 
support, and ASCH, the job scheduler that handles starting applications when 
incoming requests are received. 


ASCHPMXX members define classes of APPC/MVS transaction scheduler ini- 
tiators and provides default scheduling information when it is missing from a TP 
profile. 
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CLASSADD CLASSNAME(FAST) /* Specify the name of the class to be we i 


/* added a 

MAX(10) /* Specify that the maximum number ef 

/* of transaction initiators allowed a 

/* for this class is 10 =) 

MIN(2) /* Specify that the minimum number. ff 

/* of transaction initiators to be */ 

/* brought up for this class is 2 4 

RESPGOAL(. 02) /* Specify that the response time */ 

/* goal for transaction programs */ 

/* executing within this class is 0.02 a 

/* seconds tf 

MSGLIMIT (500) /* Specify that the maximum size of */ 

/* the job logs for TPs is 500 */ 

/* messages mh 

OPTIONS DEFAULT (FAST) /* Specify the default class - Note #1 a | 
SUBSYS(2JES?) /* name of subsystem under which ay 

/* all newly created APPC/MVS */ 

/* transaction initiators are stored*/ 

TPDEFAULT REGION(4M) — /* Note #2 */ 
OUTCLASS (A) /* Note #3 | 


Figure 50. SYS].PARMLIB(ASCHPMO00) - ASCHPMO00.LIB 


Notes: 


a. The DEFAULT(classname) is an optional parameter that specifies the 
default class of transaction initiators in which to run a TP when a class 
name is not specified in a TP profile. If the TP profile does not specify a 
class name, and there is no default defined by this parameter, then the 
request to run the TP is denied. If the DEFAULT parameter names a class 
that does not exist, an error message is displayed on the console. 


b. Region size - The region size assigned to TPs that do not specify a region 
size in ther TP profile is 2M. 


c. Output class - A is the class used as a default MSGCLASS for TPs whose 
profiles do not specify the MSGCLASS keyword in their JOB statements. 
When the SYSOUT keyword does not include a specific output class, the 
value of MSGCLASS can be used as a default. 


APPCPMXX members control the communication functions. The sample 
below defines a local LU for the APPC/MVS configuration. 


86 Multi-Platform Config 


/* APPCPMOO */ 


LUADD ACBNAME (?LOCALLU?) /* Add LU MVSLUO1 to the */ 
/* APPC/MVS configuration vy 
SCHED (ASCH) /* Specify that the APPC/MVS */ 
/* transaction scheduler is associated */ 
/* with this LU name tf 
BASE /* Designate this LU as the base LU af 
TPDATA(?TPFILE?) /* Specify the VSAM data set for */ 
/* (Suggestion SYS1.APPCTP) */ 
/* the permanent repository for */ 
/* TP profiles for this LU a 
TPLEVEL (USER) /* Specify the search order for TP ay | 
/* profiles as of | 
/* 1. TP profiles associated with a 
ys a specific user - USER ae A 
/* 2. TP profiles associated with i 
is a group of users - GROUP ey. 
/* 3. TP profiles associated with a 


Va all users of the LU name - SYSTEM*/ 
SIDEINFO DATASET(2SIFILE?) /* Specify the VSAM data set */ 


/* (Suggestion SYS1.APPCST) wee 
/* for the permanent Wf 
/* repository for the side "/ 
/* information ah 


Figure 51. SYS1.PARMLIB(APPCPM00) - APPCPM00.LIB 


2. Create VTAM Application Major Node 
Place the following sample ina VTAMLST library (usually SYS1.VTAMLST): 


APPCAPP VBUILD TYPE=APPL 

2LOCALLU2 APPL ACBNAME=?LOCALLU? , APPC=YES ,AUTOSES=1,DDRAINL=NALLOW, = 
DMINWNL=1, DMINWNR=1,DRESPL=NALLOW, OSESLIM=2, EAS=509, . 
MODETAB=?MODETAB? , SECACPT=CONV, VPACING=0, VERIFY=NONE, 
SRBEXIT=YES , DLOGMOD=? MODE? 


Figure 52. VIAM definition of APPC LU - APPLMVS.VTM 


This definition will define the APPC/MVS local LU to VTAM. Multiple 
APPC/MVS LUs may be defined. For simplicity of administration, the recom- 
mendation would be to define the smallest number of LUs needed. 


3. Add APPC Modes to the Logmode Table 


APPC modes are shown in Figure 53 on page 88. Add them to your logmode 
table, compile, and then link-edit the member into a VTAM library. Also 
include them in the default Iogmode table (ISTINCLM) so that dynamically 
created LUs can use them. 
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KKKKKKKKKKKKKKKKAKRKKRKEKKEKKKKKKKKKKKEKKERRERKKEKKKKEKKRAKERKKEKRKEKKKKKKKEH 


* LOGHODE TABLE ENTRY FOR RESOURCES CAPABLE OF ACTING ‘ 
‘ AS LU 6.2 DEVICES 6 
KKKKKKKKKKKRKKEKEKKKEREKEKKEKEKKEKKRKKEKKREKERKEKKKKKKKKKEKKKKEKKEKKEKEREKKEKKKKE 
SNASVCMG MODEENT LOGMODE=SNASVCHG, FHPROF=X' 13‘, TSPROF=X'Q7", 
PRIPROT=X‘BO', SECPROT=X'BQ' , COMPROT=X‘DOB1', 
RUSIZES=X'8686', ENCR=B‘0000' , SSNDPAC=7, 
; PSERVIC=X' o60200090G00000000000300", 
SRCVPAC=7, PSNDPAC=7, TYPE=0 : 
TITLE '#BATCH' 


KRKEKKKKRKKEKKERKRKKEKKKKREKRKAKKEEKRKKEKKKEKKEKKKREKEKERKERREKKKKKKERKRKKKRERKKKK 


+ + + & 


* ; * 
s LOGHODE TABLE FOR BATCH SESSIONS ON RESOURCES CAPABLE Ais 
* OF ACTING AS LU 6.2 DEVICES * 
* * 


KRKKKKKKKKKKKKEKEKKKKKKKEKEKKKKEKKKKKKKKKEKEEKKEKKEKKEKKKKEKKKEKKREKRKEKKEKEKREKEKKKK 


#BATCH HMODEENT LOGHODE=#BATCH, si 
ENCR=B'000G0' , SSNDPAC=3, 
SRCVPAC=3, PSNDPAC=3, RUSIZES=X'F7F7' 
TITLE ‘#INTER' 


KRKKKAKRKEKEKKKKKKKAKKRKRKKKKKKKKKKKKKKAKKAKKKKEKERKKKEKKKKKKKRRKAKKKKKAKKKKKKAKAKREK 


* * 
ad LOGHODE TABLE FOR INTERACTIVE SESSIONS ON RESOURCES . 
. CAPABLE OF ACTING AS LU 6.2 DEVICES . 
* * 


KREEKEKKKKRKEARKEKREKKKKEKKKKKAKKKKKKEKKKKEKKEKKKKKEEKKEKKEKAKRKKKEKEKKEKKKKAKKKKKKE 


#INTER HODEENT LOGHMODE=#INTER, q 
ENCR=B'0000' , SSNDPAC=7, | * 
SRCVPAC=7, PSNDPAC=7, RUSIZES=X‘F7F7' 
TITLE '#BATCHSC' 


KAAKKKKKKEKAKKKKKKKKKKKKEKKAKKKKKKKAKEKKKERKKKAKKKRAEKRRKKKKKKKKKKKKKKAKKAKK 


* * 
m LOGHODE TABLE FOR BATCH SESSIONS REQUIRING SECURE s 
* TRANSPORT ON RESOURCES CAPABLE OF ACTING AS LU 6.2 ae 
“3 DEVICES ad 

* 


KAKRKKAKKKKKKKKKAKKKKAKAKKKKKAKKKAKAKKAKAKRKKKKKKAKKKEKKKKKKKKKKKAKRKRKKEKRKKAKK 


#BATCHSC HODEENT LOGHODE=#BATCHSC, . 
ENCR=B'0000' , SSNDPAC=3, . 
SRCVPAC=3, PSNDPAC=3 , RUSIZES=X'F7F7' 

TITLE “#INTERSC' 


KAKKKKKKKKKKKKKKKKKKKKKKRKRKEKKKKKAKKKKEKKKEKKEKKKKKRKKKKKKKKKKKKARKKERKKKKEKKK 


* * 
a LOGHODE TABLE FOR INTERACTIVE SESSIONS REQUIRING * 
A SECURE TRANSPORT ON RESOURCES CAPABLE OF ACTING AS m 
m LU 6.2 DEVICES ‘i 
* : x 


KKEKKKKKKKKKKKKKKKEKKKKKKEKERKERKKKKKKKKEKKEKKRKKRKEKKKKKEKKKKKEKAKKKKKKKKKAKKRKKK 


#INTERSC MODEENT LOGHODE=#INTERSC, ‘ 
ENCR=B'0000', SSNDPAC=7, © il 
SRCVPAC=7, PSNDPAC=7, RUSIZES=X'F7F7' 
TITLE ‘CPSVCHG' 


HAKKKKKKKKKAKKKKRKKKKKKKKKKKKKEKKEKRKKKKEKKKKKKKKKKKKKKKKRKKRAEKKKKREKKKRAKKKE 


* * 
. LOGHODE TABLE FOR CP-CP SESSIONS ON RESOURCES CAPABLE E 
4 OF ACTING AS LU 6.2 DEVICES . 
* ® 


KRKKKKKEKKKKKKKEKKKEKKRKKEKKKKKKKKKAKRKKKKRKEKKKAEKEKRKKKKKKKKKKRKKEKRKEKKEKKKKEKKKKE 


CPSVCNG HODEENT LOGMODE=CPSCVHG, x 
RUS IZES=X'8686', ENCR=B' 6000", | e 
SSNDPAC=7, SRCVPAC=7, PSNDPAC=7 


Figure 53. APPC Logon Mode Entries - APPCMIODE.ASM 


7.5.3 Define a link to a partner or intermediate node 
1. Define the Token-ring adapter in NCP 


The following is a sample token-ring connection from NCP: 
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TO30T2PG GROUP ECLTYPE=(PHYSICAL, ANY) 
TO30T2PL LINE ADDRESS=(1089,FULL) ,LOCADD=?NCPLANADDR? , PORTADD=2, X 
RCVBUFC=4095 ,MAXTSL=2044 , ADAPTER=TIC2, TRSPEED=4 


* 


TO3OTRLO GROUP ECLTYPE=LOGICAL , AUTOGEN=10, PHYPORT=2 ,CALL=INOUT 
Figure 54. LAN definitions on NCP 


2. Provide for use of independent LUs on the token-ning connection 


Once the token-ring is defined in the NCP, the only additional parameter that is 
required is NUMILU on the LUDRPOOL macro. An example 1s: 


POOL1 LUDRPOOL NUMILU=100, NUMTYP1=20 , NUMTYP2=20 


In this example the NCP will be able to support up to 100 independent LUs 
that are using dial connections (token-nng or switched lines). 


7.5.3.1 Additional LEN configuration 
Place the following in a VTAM switched major node definition. It assumes that the 
partner is not another VTAM. If the partner LU is on another VTAM system, then 
the link definitions for the token-ring shown above need to be for a subarea link, or 
the cross-domain links need to be defined so that normal LU routing within the 
subarea network will resolve the locations of the session partners. 


WSN VBUILD TYPE=SWNET ,MAXGRP=2 , MAXNO=2 
PARTPU PU  ADDR=04, 

CPNAME=?PARTNERLU?, 

PUTYPE=2, 

MAXDATA=2012, 

MAXPATH=1, 
2PARTNERLU? LU — LOCADDR=0 ,MODETAB=?MODETAB? , DLOGHOD=? MODE? 


Figure 55. SYSI.VTAMLST(WSN) - WSN.VTM 


PS P< OK OK OOK 


7.5.4 Configure to run as a client 


7.5.4.1 Define CPI-C side information 
1. Create VSAM Dataset for CPI-C Side Information 


The following example job creates the VSAM dataset for Common Program- 
ming Interface-Communications(CPI-C) Side Information. It is needed for 
APPC/MVYVS to be able to initiate TPs that use side information. While it is 
used exclusively when APPC/MVS 1s acting as a client, it 1s included here so 
that the side information entry in SYS1.PARMLIB(APPCPMO00) will reference 
an existing dataset. Later, new side information entries may be added to the 
dataset. | 
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//APPCOO2 JOB CLASS=A,MSGCLASS=A,MSGLEVEL=(1, 1) 
/*JOBPARM LINES=9999, TIME=1440 
//SISAMPLE EXEC PGM=IDCAMS 
//TSSCO1 = DD  DISP=0LD, UNIT=3380, VOL=SER=2VOL2 
//SYSPRINT DD = SYSOUT=* 
— J /SYSABEND DD = =SYSOUT=* 
//AMSDUMP DD SYSOUT=* 
//SYSIN. DD * 
DEFINE CLUSTER (NAME(?SIFILE?) - /* side info data set name = SYS1.APPCSI */ 
VOLUME(?VOL?) - /* the volume where the VSAM datasets are defined */ 
INDEXED REUSE - 
SHAREOPTIONS(3 3) - 
RECORDSIZE(248 248) - 
KEYS(112 0) - 
RECORDS(50 25)) - 
DATA - 
(NAME(?SIFILE?.DATA)) - /* side info data set name 
INDEX - 
(NAME (?SIFILE?. INDEX) ) /* side info data set name = SYS1.APPCSI */ 


Figure 56. Sample JCL for Side Information VSAM dataset - ATBSIVSM.JCL 


SYS1.APPCSI */ 


CPI-C side information is saved in the VSAM dataset created by the sample 
JCL file ATBSIVSM.JCL. | 


//STADDO JOB CLASS=A,MSGCLASS=A,MSGLEVEL=(1, 1) 
ORS Ty eee Bane me hO RE Ce Rea ae Coat ae nh Ree ce 
//STEP EXEC PGM=ATBSDFMU 
//SYSPRINT DD SYSOUT=* 
//SYSSDLIB DD DSN=SYS1.APPCSI,DISP=SHR 
//SYSSOOUT DD SYSOUT=* 
//SYSIN. OD * 
STADD 
DESTNAME (?SYMDEST?) 
TPNAME (?TPNANE? ) 
MODENAME (?HODE? ) /* see Note #1 */ 
PARTNER LU(?PARTNERLU?) /* see Note #2 */ 
i ; 
Figure 57. Sample JCL CPI-C Side Information Job - SIADD.JCL 
2. Add new CPI-C side information entnes 
The above example SIADD.JCL shows the JCL to add new CPI-C Side Infor- 
mation entnes to the CPI-C Side Information dataset. 
Notes: 
1. If no mode name is specified, a default mode name might be available 


2. If no partner LU name is specified, APPC/MVS assumes the TP resides in the 
local LU. 
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7.5.4.2 Other client configuration 
It will not usually be necessary to connect from VIAM out to other nodes. 
However, if it becomes necessary to do so, a line must be added to the switched 
major node defined above (WSN.VTM). The following line can be added just 
before the LU definition: 


PATH1 PATH GRPNM=TO30TRLO, DIALNO=?LANADDRESS? , PID=1 


The GRPNM parameter references a group of logical LAN lines defined 1n the 
NCP. See Figure 54 on page 89 for an example of defining logical LAN lines in 
the NCP. 


7.5.9 Configure to run as a server 


7.5.5.1 Define transaction programs (TPs) 
A VSAM Dataset must first be created in order for APPC/MVS to be able to asso- 
ciate TP names with particular job streams when an incoming request to start a TP 
is received. Once the dataset is created, new TP’s may be added by following step 2 
and step 3 below. 


When adding new transaction programs, you may have a server transaction program 
CLIST or REXX EXEC, or a compiled program. Regardless of how your TP is 
written, it needs to be defined to APPC/MVS by creating a TP profile for the 
program, and by adding the TP profile to the TP VSAM dataset. 


1. Create VSAM Dataset for Transaction Program (TP) Profiles 
The following job creates the VSAM dataset for TP profiles. 


//APPCOO1 JOB CLASS=A,MSGCLASS=A,MSGLEVEL=(1, 1) 
/*JOBPARM LINES=9999, TIME=1440 
//TPSAMPLE EXEC PGM=IDCAMS 
//NOL1 DD DOISP=O0LD,UNIT=3380,VOL=SER=2VOL? /* The volume for the VSAM datas=<5 * 
//SYSPRINT DD SYSOUT=* 
//SYSABEND DD SYSOUT=* 
//AMSDUMP DD SYSOUT=* 
//SYSIN DD * 
DEFINE CLUSTER (NAME(?7TPFILE?) - /* TP profile data set name=SYS1.APPCTP*/ 
VOLUMES (2VOL?) - /* The volume where the VSAM datasets are defined */ 
INDEXED REUSE - 
SHAREOPTIONS(3 3) - 
RECORDSIZE(3824 7024) - 
KEYS(112 @) - 
RECORDS(300 150)) - 
DATA - 
(NAME(?TPFILE?.DATA)) - /* TP profile data set name = SYS1.APPCTP */ 
INDEX - 
(NAME(?TPFILE?.INDEX)) /* TP profile data set name 


SYS1.APPCTP */ 
/* 
Figure 58. JCL for TP profile VSAM dataset - ATBTPVSM.VT™M 


2. id=clist.Add transaction program to library 


¢ REXX EXEC - If you have the transaction program(APINGD) REXX 
CLIST, add it to a public CLIST dataset(??CLIST.DATASET?). The TP 
profile for the REXX example below assumes it has been added to dataset 
APPC.CLIST. 
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¢ Compiled program - If you have the transaction program(APINGD) com- 
piled program, add the program to the 7APPC.LOADLIB?. 


3. Create TP profile for transaction program(APINGD) 


¢ REXX EXEC - The following job runs the APPC/MVS administrative 
utility to add a TP profile for the transaction program(APINGD). It starts 
the TSO Terminal Monitor Program IKJEFT0O1, which in turn calls the 
REXX CLIST located in the APPC.CLIST dataset. 


//TPADDO JOB CLASS=A,MSGCLASS=A,MSGLEVEL=(1, 1) 
//STEP EXEC PGM=ATBSDFMU 
//SYSPRINT DD SYSOQUT=* 
//SYSSOLIB DD DSN=2?TPFILE?,DISP=SHR 
//SYSSDOUT DD SYSOUT=* | 
//SYSIN DD DATA,DLM=XX 
TPADD 
TPNAME (2? TPNAME? ) 
ACTIVE(YES) 
TPSCHED DELIMITER (##) 
TAILOR SYSOUT (NO) 
TAILOR ACCOUNT (NO) 
CLASS (FAST) 
TPSCHED_ TYPE (STANDARD) 
JCL_DELIMITER(END OF JCL) 
//APPCO4 JOB MSGLEVEL=(1,1),MSGCLASS=A 
//TKJACCNT EXEC PGM=IKJEFTO1, 
PARM='EXEC ''2CLIST.DATASET? (APINGD)''' 
//SYSUADS DD DISP=SHR,DSN=SYS1.UADS 
//SYSLBC OD DISP=SHR,DSN=SYS1.BRODCAST 
//STEPLIB OD DSN=ISP.V3R2MQ.ISPLOAD,DISP=SHR 
//SYSTSPRT OD SYSOUT=*,FREE=CLOSE 
//SYSTSIN OD DUMMY 
//SYSPRINT OD SYSOUT=* , FREE=CLOSE 
END OF JCL 
KEEP MESSAGE _LOG(NEVER) /* Note # */ 
## 
XX 
| 
Figure 59. JCL to add a TP profile to the VSAM dataset - TPADD.JCL 


Notes: 


a. To log messages, specify KEEP_MESSAGE LOG(ALWAYS) or 
KEEP MESSAGE LOG(ERROR) along with 
MESSAGE DATA_SET(name). 


¢ Compiled program - The following job runs the APPC/MVS administrative 
utility to add a TP profile for the transaction program(APINGD). It starts 
the TSO Terminal Monitor Program IKJEFTO1, which in turn calls the 
REXX CLIST located in the APPC.CLIST dataset. 
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//TPADDO JOB CLASS=A,MSGCLASS=A,MSGLEVEL=(1, 1) 
//STEP EXEC PGM=ATBSDFMU 
//SYSPRINT DD SYSOUT=* 
//SYSSDLIB DD DSN=SYS1.APPCTP,DISP=SHR 
//SYSSDOUT DD SYSOUT=* 
//SYSIN 0D DATA,DLM=XX 
TPADD 
TPNAME (2T PNAHE? ) 
ACTIVE(YES) 
TPSCHED_ DELIMITER (##) 
TAILOR_SYSOUT (NO) 
TAILOR ACCOUNT (NO) 
CLASS (FAST) 
TPSCHED_ TYPE (STANDARD) 
JCL_DELIMITER(END_ OF _JCL) 
//APPCO4 JOB MSGLEVEL=(1,1) ,MSGCLASS=A 
//IKJACCNT EXEC PGM=?TPNAME? , 
//SYSUADS DD DISP=SHR,DSN=SYS1.UADS 
//SYSLBC DD DISP=SHR,DSN=SYS1.BRODCAST 
//STEPLIB ODD DSN=2APPC.LOADLIB? ,DISP=SHR 
//SYSTSPRT DD SYSOUT=* , FREE=CLOSE 
//SYSTSIN 0D DUMMY 
//SYSPRINT DD SYSOUT=*, FREE=CLOSE 
END_OF_JCL 
KEEP_MESSAGE_LOG (NEVER) /* Note # */ 


Figure 60. JCL to add a TP profile to the VSAM dataset - TPADD.JCL 


Notes: 


a. To log messages, specify KEEP MESSAGE LOG(ALWAYS) or 
KEEP MESSAGE LOG(ERROR) along with 
MESSAGE DATA_SET(name). 


7.6 Running APING 
To run APING from TSO enter: 
CALL ‘2?APPC.LOADLIB? (APING) ' ' 2SYNDEST?! 


It can also be run from a batch program. Below is a sample job: 


//APINGO JOB CLASS=A,MSGCLASS=A,MSGLEVEL=(1,1) ,NOTIFY=NEALS 


Yi a a i a a) 


//STEP EXEC PGM=APING, PARM='?SYMDEST?' 

//STEPLIB DD DSN=?APPC.LOADLIB? ;DISP=SHR 

// DD DSN=PLI.V2R3MO.STBHLINK,DISP=SHR 
DD = DSN=EDC.V2R1IMO.SEDCLINK, DISP=SHR 

//{SYSPRINT DD  SYSOUT=* 

jm 

Figure 61. JCL to run APING - APING.JCL 


Note: It may be necessary to change the PLI.V2R3M0.SIBMLINK and the 
EDC.V2R1IMO.SEDCLINK DD statements to match levels of C and PL/1 on your 
system. 
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7. How to find ... 
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LU name 


For APPC/MVS, this is configured in SYS1.PARMLIB(APPCPMxx). The 
LUADD parameter includes an ACBNAME. The ACBNAME defines an 
APPC/MVS LU Name. This name is also included on an APPL definition 
statement in an APPL major node of VTAM. 


Control Point (CP) name 


VTAM, being a LEN node, does not have a CP (Control Point) name for 
APPN use. It does, however, have an SSCPNAME (System Services Control 
Point Name). If in configuring a partner platform a CP name 1s needed, use the 
SSCPNAME instead. It is also set in the ATCSTRxx member of the 
VTAMLST dataset. 


Network Name 


It is defined in a member named ATCSTRxx of a dataset with the DDNAME 
of VTAMLST in the VTAM start procedure. The “xx” is two digits, and the 
default is 00. ATCSTRxx is the VTAM start options. The NETID parameter 
defines the network name. 


LAN address 


The LAN address is coded in NCP on a LINE macro using the LOCADD 
parameter. 


8.0 OS/2 Extended Services and Networking Services/2 
Configuration : 


This chapter describes how to configure APPC on an OS/2 workstation that is con- 
nected to a token nng local area network. It is directed at the following software 
configuration: 


8.1.1 Prerequisites 
¢ OS/2 EE 1.3 with Networking Services/2 or OS/2 2.0 Extended Services 


¢ Token-ring adapter 
This chapter describes how to configure OS/2 on a workstation connected to a 
LAN. For more information: | 

¢ SAA Networking Services/2 Administrator's Guide, SC52-1110-00 

¢ ES OS/2 APPC Programming Referece, S04G- 1025-00 

© ES OS/2 APPN/LU6.2 Connection and Management, SG22-1052-00 


8.2 Terminology 


The terminology table maps the standard networking terms defined in 1.10, “How 
do I Configure a Network?” on page 7 to the terms used by OS/2. 


Standard Term OS/2 Panel Config OS/2 NDF Term 
Term 


UW Nas 
Parner LU Na 


Adjacent LAN Address LAN Destination Destination Address 
Address 


Use the following worksheet to determine all the values you will need to configure 
this platform. The worksheet is split into two parts: values determined by referring 
to the Guide introduction or other platform chapters, and values that are local to 
this platform which you create. There are three columns. The left-most column 
has a variable name that starts and ends with a question mark (?), the middle 
column descnbes what the variable 1s used for and how to determine its value, and 
the nght-most column is left blank so you can fill in a value. Whenever there is a 
reference in this chapter to a value in the left column, substitute the value you have 
wnitten in the nght column. 


For example, if you are following our excellent recommendations, you will write 
#INTER in the nght column on the 7MODE? line. Then in Figure 69 on 
page 104 you will type #INTER on the OS/2 screen that looks like this: 
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MOdename ==> #INTER 


Symbol How to determine the value for this symbol : 
here 


Values that much match with other places 


?LUNAME? 


This is the symbol that refers to the LU name of the machine 
you are defining to the network. 1 to 8 character field consisting 
of alphanumeric characters which is the LU name of the node. 
Choose a name that is unique within the same network name. 
An LU name 1s defined by defining a CPNAME in OS/2. Refer 
to 1.10, “How do I Configure a Network?” on page 7 for more 
information about LU names. 


2?CPNAME? 


This is the symbol that refers to the Control Point name of your _ 
machine. It should be the same as your 7LUNAME?. Refer to 
1.9, “What Is APPN?” on page 6 for more information about 

control points. 


INETWORK? This is the symbol that refers to the network name of the 
machine you are defining to the network. 1 to 8 character field 
consisting of alphanumeric characters. There is a structured 
format for the network name which includes the country code, 
enterprise code and network suffix code. This format insures 
uniqueness around the world. Call your local IBM branch office 
for the format information and to register your network name. 
Refer to 1.10, “How do I Configure a Network?” on page 7 for 


more information about network names. 


?PARTNERLU? 


This is the symbol for the partner’s LU name. Refer to the 
“How to find...” section of the partner computer’s configuration 
chapter for this value. Refer to 1.10, “How do I Configure a 
Network?” on page 7 for more information about the partner 
LU name. 


?PARTNERCP? 


This is the symbol for the Control Point(CP) name of your 
partner. Refer to the “How to find..” section of the partner 
computer’s configuration chapter for this value. 


This is the symbol for the network name of the partner com- 
puter. Use the network name from the partner computer’s “How 
to find...” section. 


This is the symbol for the LAN Address of the partner com- 
puter. (Or the LAN Address of a network node, if the link 1s 
being made to a network node.) Refer to the “How to find...” 
section of the partner computer’s configuration chapter for this 
value. ; 


2?PARTNERNET? 


27LANADDRESS? 


ITPNAME? This is the Transaction Program name. It is a name that is sent 
across the network to the server machine. The server machine 
then maps this TP Name to an executable program. The TP 
Name 1s usually specified in a client/server product’s documenta- 


tion. For APING, the TP Name on the server is APINGD. 
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Symbol How to determine the value for this symbol Fill in value 
here 


YTPPATH? This is the fully-specified path and filename of the transaction 
program’s executable code. For example, if OS/2 is installed on 
the C:\ drive, this value could be: 
C:\OS2\SAMPLES\APING\APINGD.EXE 


IMODE? This is the symbol for the mode name. See 1.6, “What Is a 


Mode?” on page 5 for a discussion of modes. Often, a 
client/server product’s documentation specifies what mode must 
be used by that product. APING can use any mode (this can be 
specified on the APING command line), but the default is 
HINTER. It is recommended that you use one of the architected 
modes discussed in the “What Is a Mode?” section. 


Local values 


2?NODETYPE? 


?PLUALIAS? 


?7LINKNAME? 


This is the symbol for the APPN node type. This should be EN 
to be configured as an end node, or NN to be configured as a 
network node. In most cases, you will configure as a EN. 


This is the symbol for the Partner LU Alias. 1 to 8 characters 
that designates a nickname for the Partner LU. Alias names are 
case sensitive. 


This it the symbol for the link name of a logical link. | to 8 
letters or numbers which will be used as a local name on the 
OS/2 machine to refer to the link to a partner computer. You 
can choose any name you like, but since you will use this name 
later to refer to this link, choose a meaningful name. 
(suggestion: LINK001) 


This is the symbol for the CPI-C side information symbolic des- 
tination name. It is any 1-8 character name you choose. It will 
be used locally on the OS/2 machine to refer to a CPI-C side 

information entry. 


2S YMDEST? 


8.3 Working with OS/2 Configuration 


8.3.1 Starting/stopping APPC 


APPC is started and ended by starting and stopping Communications Manager. 


¢ Starting: Type “STARTCM” from the OS/2 command prompt or mouse click 
on “Communications Manager”. 


¢ Stopping: In Communications Manager, choose ‘Exit’ from the Action Bar. 
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8.3.2 Other commands _ 
¢ Displaying link information: To display link information, choose “Manage 
SNA Logical Links” from the Communications Manager Folder or type 
“APPNLINK’ from an OS/2 command prompt. You can also use 
APPNLINK to activate and deactivate links. This command is only available 
in ES OS/2 2.0. | | 


Displaying active SNA Config Info: To display active configuration informa- 
tion, choose “Display active SNA Configuration’ from the Communications 
Manager Folder or type “PMDSPLAY” from an OS/2 command prompt to 
display active configuration information. 


¢ APPNV.CTL: This file serves two purposes. It gives a descnption of the node 
definitions file and the format of the commands that can be placed 1n this file. 
This file also defines the command, parameter, and value names that are 
allowed in the node definitions file. 


8.4 Configuration 


8.4.1. Working with APPC configuration 


The following configuration steps will be discussed: 
1. Define yourself to the network 
2. Define a link to a partner or intermediate node 
a. Additional LEN configuration 
b. Other link configuration 
3. Configure to run as a client 
a. Define CPI-C side information 
b. Other client configuration 
4. Configure to run as a server 
a. Define transaction programs 


b. Other server configuration 


OS/2 configuration for APPC/APPN can be accomplished via several methods: 
¢ Panel Configuration for OS/2:2.0 
¢ Text editing a Node Definitions File (NDF) for OS/2 1.3 or OS/2 2.0 
. ‘Panel Configuration for OS/2 1.3 + NS/2. 


The Panel Configuration facility accomplishes the same function as text editing the 
NDF file and adding the configuration statements. This chapter will discuss both 
Panel Configuration for OS/2 2.0 and NDF file editing for OS/2 1.3+ NS/2 and 
OS/2 2.0. It will not discuss Panel Configuration for NS/2. 
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Your NDF file is located in the \CMLIB\APPN directory. It has the same filename 
as your Communication Manager configuration file whose file extension is ”.CFG”. 
However, the NDF file has the file extension “.NDF”. 


There are example NDF and CFG files provided with this guide called BASE.NDF 
and BASE.CFG. If you wish to configure a machine from with no current config- 
uration, copy the BASE.NDF file into the \CMLIB\APPN directory and the 
BASE.CFG file into the \CMLIB directory. If you do not want to lose a current 
configuration, do not copy the BASE files. You can, however, cut and paste the 
commands needed from the BASE.NDF file to your own NDF file. The NDF File 
Configuration instructions show what commands and parameters should be in the 
NDF file. 


If you wish to use the Panel Configuration for OS/2 2.0, follow the Panel Config- 
uration instructions in this chapter. This method also will place the correct com- 
mands in your NDF file. 


8.4.2 Define yourself to the network 
Before an OS/2 machine can communicate on a network, it must define itself to the 
network. This configuration 1s usually done when OS/2 is installed. 


8.4.2.1 Panel configuration: 


1. Define LU name 


You can define (or find if it is already configured) your LU name in the Local 
Node Characteristics panel. 


Follow this sequence of panels: 


-- Select Communications Manager from the 0S/2 Window List 
-- Advanced 
-- Configuration, (type Config file name and press ENTER) 
-- SNA feature profiles 
-- SNA Network Definitions 
-- Create/Change 
-- Local Node Characteristics 
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Required Features: 


Network ID: 2HETWORK? 


Local node name: 2?LUHAME? 
Node type: 
o End Node to Network Node Server 
o nd Node - No Network Node Server 
o Network Node 
Your network node server address: ?LANADDRESS? 
Optional Features 
Local Node ID 050 
Local Node Alias Name 


Comment | Configuration is Fun! 


_ Activate Attach Manager at start up 


Figure 62. Local Node Characteristics. This screen displays the Local Node characteristics 
The LU name is the Local node name on this screen. 


Notes: 


a. Check the “Activate Attach Manager at start up” box so that programs can 
be Attach Manager started. 


2. Define your node type 


OS/2 can be either an end node or network node. If you choose the End Node 
to Network Node Server and fill in the network node address, a connection will 
automatically be configured to your network node and you can skip the “Define 
a link to a partner or intermediate node” configuration step. 


8.4.2.2 NDF file Configuration: 
1. Define LU name 


You can define (or find if it is already configured) your LU name in the 
DEFINE LOCAL CP command in the following Node Definitions File 
(NDF) excerpt: 


define_local_cp 
fq_cp_name(?NETWORK?.2LUNAME) 
cp_alias(mylu) 
node_1d(x’00000’) 
node_type(?7?NODETYPE?); 


Figure 63. NDF file excerpt from BASE.NDF for DEFINE_LOCAL_CP. 


2. Define Node Type 


OS/2 can be either an end node or a network node. 
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e endnode- ?NODETYPE?=EN 
¢ network node -7NODETYPE?= NN 


8.4.3 Define a link to a partner or intermediate node 
A link is configured by defining a connection on the panels or a logical link in the 
NDF file. 


8.4.3.1 Panel configuration: 


1. To define a link, follow this sequence of panels: 


-- Communications Manager from the OS/2 Window List 
-- Advanced 
-- Configuration. type configuration file name and press ENTER 
-- SNA feature profiles 
-- SNA Network Definitions 
-- Connections 


2. A list of nodes will be display. Select the type of node you are connecting to: 
« Network Node - choose Network Node 
e Partner Node - choose Peer Node 


¢ Host Node - choose Pnmary Host 
3. Select the type of connection you desire (e.g. IBMTRNET for token-nng) 


4. The screen, “Creating a Connection to a Peer Node” will be shown. Fill in the 
appropnite values from the Required Values Table 


Creating a Connection to a Peer Node - ESBASE 


Link Name: 2LINKNANE 2 
Partner network ID: 2PARTHERNET? 
Partner node name: 2PARTNERLU? 
LAN destination address: ?2LANADDRESS? 
Comment: 


Figure 64. Creating a Connection. This screen displays the parameters for defining a con- 
nection to a peer node. 


8.4.3.2 NDF file Configuration 
Define a link to the network node: To define a link to your network node, your 
Node Definitions File should contain a “define_logical link” command, 
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define_logical link 
link_name(?7LINKNAME?) 
adjacent_node_type(learn) 
preferred_nn_server(yes) 
dic_name(ibmtmet) 
adapter_number(0) 
destination_address(x’7LANADDRESS”) 
cp _cp_session_support(yes) 
activate _at_startup(yes); 


Figure 65. NDF file excerpt from BASE.NDF for DEFINE_LOGICAL LINK for 
network node link. 


Define a link directly to your partner or to a LEN node.: ‘To define a link directly 
to your partner, your Node Definitions File should contain a “define_logical_link” 
command like this: 


define_logical link 
link _name(?LINKNAME?) 
fq_adjacent_cp_name(?PARTNERNET?.2PARTNERCP?) 
adjacent_node_type(learn) 
dic_name(ibmtrnet) 
adapter number(0) 
destination_address(x?7>LANADDRESS?) 
Cp _cp_session_support(no) 
activate _at_startup(no); 
solicit_sscp_session(no); 


Figure 66. NDF file excerpt from BASE.NDF for DEFINE LOGICAL LINK for partner 
link. 


For a link to a host LEN node that requires 3270, the following define_logical_link 
parameter should be changed to yes. 


solicit_sscp_session(yes); 


Also, to configure 3270 sessions the 7LANADDRESS? should match the Destina- 
tion Address in 3270 Feature Profile Connections. 


8.4.3.3 Additional configuration 
Define partner LU’s: When the partner LU is NOT accessible theoueh a NN, as in 
a LEN node connection or a direct link to your partner, you must define the path 
to the partner LU. 


For your machine to be able to locate the partner LU, a correlation between your 
link definition and the partner LU must be established. This is done by associating 
the partner LU to a particular link. 
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Panel configuration: Follow this sequence of panels: 


-- Communications Manager from the 0S/2 Window List 
-- Advanced 
-- Configuration, type config file name and press ENTER 
-- SNA feature profiles 
-- SNA Network Definitions 
-- Connections 
-- Link Name defined above for the host or partner connection 
-- Define Partner LU's 


To add a Partner LU, enter the LU name, alias, and comment. Then select 
Add button. 


To change a Partner LU, select and LU from the list, change the LU name, 
and/or Comment fields and select the Change button. 


To Delete a Partner LU, select an LU from the list and select the Delete 


LU name Alias 
LU name: ?PARTHERLU? ?PARTNERLU? ?PLUALIAS? 
Alias: 2?PLUALIAS? 
Comments: UNC #1 


Figure 67. Partner LU. This screen displays the Partner LU parameters. 


NDF file Configuration: 


define_partner_lu 
fq_ partner lu name(??PARTNERNET?2PARTNERLU?) 
descnption(partner lu for appc on the host) 
partner _lu_alias(?7PLUALIAS?) 
partner lu_uninterpretred_name(?PARTNERLU?) 
max_mc_ ll send_size(32767) 
conv_security_ venfication(NO) 
parallel_session_support( YES); 


define_partner_lu_location 
fq_partner_lu_name(?PARTNERNET?.2?PARTNERLU?) 
wildcard_entry(NO) 
fq owning cp name(?7PARTNERNET?.2PARTNERCP?) 
local_node_nn_server({NO);: 


Figure 68. NDF file excerpt for define_partner_lu and define_partner_lu_location. 
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8.4.4 Configure to run as a client 


8.4.4.1 Define CPI-C side info entry 
APING and many other applications do not require CPI-C side information. Refer 
to 1.7, “What Is CPI-C side information?” on page 5 for a discussion fo CPI-C side 
info entries. If you wish to use a symbolic destination name as the target of a con- 
versation, you must define a CPI-C side info entry. : 


Panel Configuration: Follow this sequence of panels: 


-- Communications Manager from the 0S/2 Window List 
-- Advanced 
-- Configuration, type config file name and press ENTER 
-- SNA feature profiles 
-- SNA Network Definitions 
-- Additional SNA Features 
-- CPI-C Communications Side Info 


Creating a Side Information - 
Partner LU 


o Fully qualified name 2PARTNERNET?. 2PARTNERLU? 
o Alias 2PLUALIAS? 


Partner TP 


__ Service TP 
TP name: 2TPHAME? 


Security Type 
o Same o None o Program 
Hode Name: ?HODE? 


Comment: 


Figure 69. CPI-C Side Info. This screen displays the CPI-C Side Information parameters. 


NDF File Configuration: To define a CPI-C side info entry, your Node Definitions 
File should contain a “define _cpic_side_info” command, 


define_cpic_side_info symbolic_destination_name(?SYMDEST?) 
fq_partner_lu_name(?7PARTNERNET?.2PARTNERLU?) 
mode_name(?\IODE?) 
tp_name(?7 TPNAME?); 


Figure 70. NDF file excerpt for defining a CPI-C side info entry. 
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8.4.4.2 Other Client Configuration 
Define Partner LU Alias: An additional feature of defining partner LUs is that you 
can provide an alias for the actual partner LU name. For example, you could 
define SERVER to be an alias for PARTNERNET.PARTNERLU. Alias’s are 
case sensitive; SERVER 1s a different alias than “server.” 


If you choose to define partner LUs, either to provide an alias for use when running 
a client program, or to restrict the names of partner clients that can contact you, use 
a “define_partner_lu” command as follows in the NDF: 


Panel configuration:: Follow the below sequence of panels: 


-- Communications Manager from the 0S/2 Window List 
-- Advanced | 
-- Configuration, type config file name and press ENTER 
-- SNA feature profiles 
-- SNA Network Definitions 
-- Connections 
-- Link Name defined above for the host connection 
-- Define Partner LU's 


Creating a Partner LU - ESBASE 


Fully Qualified 
LU name: -2PARTHERNET?2. 2PARTHERLU? 
Alias: | 2?PLUALIAS? 


0 Conversation security verification 


Comment: 


Figure 71. Partner LU. This screen displays the Partner LU parameters. 
NDF File Configuration: 


define_partner_lu 
fq_partner lu_name(?PARTNERNET?.2PARTNERLU?) 
partner_lu_alas(?7PLUALIAS?,?plualias?); 


Note: Because the alias is case sensitive, is recommended that you 
define the alias (PLUALIAS) in both upper and lowercase. This can only be 
done in the NDF file as in the example above. 


Figure 72. NDF file excerpt for Partner LU.. 
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8.4.5 Configure to run as a server 


8.4.5.1 Define transaction programs 
| To run OS/2 as the target of a conversation, you must, in addition to the common 
configuration steps above, define a TP on your machine that will be the target 
program of the conversation. 


Panel configuration: Follow this sequence of panels: 


-- Communications Manager from the 0S/2 Window List 
-- Advanced 
-- Configuration, type config file name and press ENTER 
-~- SNA feature profiles 
-- SNA Network Definitions 
-- Additional SNA Features 
-- Transaction Program Definitions 


Creating a Transaction Program 


Options: 

_ Conversation security required | _ Service TP 
Transaction Program (TP) name : ?T PHAME? 

0S/2 program path and file name: 2TPPATH? 

Program parameter string : see note 1 below 

Icon path and file name 


Comment 


Figure 73. TP definition. This screen displays the TP definition parameters. 


Click on the ‘Continue’ button and see see note 2 below for TP program operation 
parameter. 


NDF File Configuration: To define a transaction program to your network node, 
your Node Definitions File should contain a “define_tp” command, 


define_tp 
tp_name(?7TPNAME?) 
filespec(7 TPPATH?) 
parm_stnng() see note | below 
tp_operation(nonqueued_am_ started) see note 2 below 


program _type(vio_windowable); 


Figure 74. NDF file excerpt from BASE.NDF for DEFINE_TP. 
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Notes: 
1. Parameter string 


Any command line parameters that need to be run with the program are entered 
here. 


2. TP program operation 


This parameter indicates how the local TP is started as a server. It can be one 
of the following: 


* QUEUED_OPERATOR STARTED 

* QUEUED_OPERATOR_PRELOADED 
- QUEUED_AM STARTED 

*- NONQUEUED_AM_STARTED 


8.4.5.2 Other Server Configuration 
Since both Extended Services and Networking Services/2 support APPN, you do 
not need to define partner LU names. The partner LU can be located through 
APPN services. 


When inbound implicit partner LU support is enabled, the computer has the capa- 
bility to accept an incoming BIND request that contains a partner LU name that is 
not defined at the local node. To enable any partner to call you when your com- 
puter 1s a server, make sure your Node Definitions File contains the following: 


define defaults 
umplicit_ inbound _plu_support(yes); 


Figure 75. NDF file excerpt for implicit inbound_plu_support. 


Note: The implicit_inbound_plu_support cannot be changed from the panel config- 
uration. 


8.4.6 Verifying configuration 
You must verify the changes you make to the configuration by using one of the 
following methods. 


¢ Panel configuration: Choose Verify from the action bar to .venfy and update 
your configuration. Answer “Yes” to “Do you want to update active configura- 
tion?” 7 

¢ Panel Configuration: Choose the Verify icon from the Communications 
Manager Folder 


¢ NDF Configuration - Run the following ‘appnv’ command from the OS/2 
Command prompt with the /e option to venfy and update your configuration. 
Type APPNV, then your NDF file name. 
‘appnv < NDF file name> .NDF’ 
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You must stop and restart Communications Manager to make changes active. 


8.5 Running APING 


Run the APING executable from the OS/2 Command prompt with the following 
parameters: | 


¢ Parameter = 7?PARTNERNET?.2PARTNERLU? or 7?PLUALIAS? or 
?2SYMDEST? 


¢ Options = Any options flags you wish to run with APING. Type ‘APING 7? 
for list. 


APING ?PARTNERNET?.?PARTNERLU? 


8.6 How to find... 


8.6.1 Panel Configuration 
« LU name 


You can find your local LU in the Local Node Characteristics panel. 


-- Communications Manager from the 0S/2 Window List 
-- Advanced 
-- Configuration, type Config file name and press ENTER 
-- SNA feature profiles 
-- SNA Network Definitions 
-- Local Node Characteristics 


The LU name 1s the Local Node Name on the panel. 
¢ CP name 

The CP name is the same as the LU name found above (Local Node Name). 
e Network Name 

The Network Name is the Network ID in the above panel 


¢ local LAN address - cannot be found 1n the panels 


8.6.2 NDF File 


e LU name 


You can find your LU name in the DEFINE_LOCAL CP command in the 
following Node Definitions File excerpt: 
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define_local_cp 

fq _cp_ name(??NETWORK?.2LUNAME?) 
cp_alias(mylu) 

node_id(x’7?NODEID?) 

node_type(en); 


Figure 76. NDF file excerpt from BASE.NDF for DEFINE_LOCAL CP. 


The LU name is LUNAME. 
« CP name 

The CP name is the same as the LU name found above. 
e Network Name 


The Network Name is the NETWORK vaniable in the excerpt of the 
DEFINE LOCAL_CP command. 


¢ local LAN address 


The LAN address is a 12-digit hexadecimal value that identifies your token-ring 
adapter to the network. There isa LAN address hard-coded on the Token- 
Ring adapter in the NS/DOS machine. This hard-coded value is sometimes be 
over-ridden with something called a “locally administered address.” You can 
find your LAN address in the following ways. 


— Check the computer’s \IBMCOM\LANTRAN.LOG file if you are using 
OS/2 2.0. or in the \CMLIB\ACSLAN.LOG file if you are using OS/2 1.3 
+ NS/2. You will see a line that says: 


Adapter X has node address (LANADDRESS’ The value in 
LANADDRESS 1s your local LAN address. 


— Run diagnostics on the computer’s reference diskette: 
1. Boot the machine on its reference diskette 
. Press Enter to clear the main panel 
. Press Ctrl+ A to start advanced diagnostics 
. Select “System checkout” 
. Press “Y” to indicate the list 1s correct 
. Select “Run tests one time” 
. Cursor down to the “Pnmary Token-Ring Adapter and press Enter 


. Select the proper cable type 


50 Oo NHN ON Ff WY KN 


. Press enter on the panel asking you to disconnect your cable (you don’t 
actually need to disconnect it for this exercise) 


10. Press enter when told the next screen will contain important informa- 
tion 


11. On the information screen, the value after Adapter Address is you LAN 
address (you may need to Page Down to see this value). 
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12. After making note of the Adapter Address, remove the reference 
diskette, reconnect your cable if you disconnected it, and press Ctrl-Alt- 
Delete to reboot your machine. 
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9.0 OS/2 CM/2 Configuration 


This chapter describes how to configure APPC for a Communications Manager/2 
(CM/2) workstation that is connected to a token ring local area network. It is 
directed at the following software configuration: 


9.1.1 Prerequisites 
¢ OS/2 2.0 or later 


¢ Communications Manager/2 1.0 


¢ Token-ring adapter 


For additional information about configuring CM/2, see: 
¢ CM/2 Installation, Configuration and Administration, SBOF-4386-00 
¢ CM/2 Configuration Guide, SC31-6171-00 
¢ CM/2 APPC Programming Guide and Reference, SC31-6160-00 


9.2 Terminology 


The terminology table maps the standard networking terms defined in 1.10, “How 
do I Configure a Network?” on page 7 to the terms used by CM/2. 


Standard Term CM/2 NDF Term 
Network Name Network Name 
Pare LU Nan 


Adjacent LAN Address LAN Destination Destination Address 
Address 


9.3 Communications Manager/2 APPC Configuration Worksheet 


Use the following worksheet to determine all the values you will need to configure 
this platform. The worksheet is split into two parts: values determined by referring 
to the Guide introduction or other platform chapters, and values that are local to 
this platform which you create. There are three columns. The left-most column 
has a variable name that starts and ends with a question mark (?), the middle 
column descnbes what the variable is used for and how to determine its value, and 
the nght-most column 1s left blank so you can fill in a value. Whenever there is a 
reference in this chapter to a value in the left column, substitute the value you have 
written in the nght column. 


For example, if you are following our excellent recommendations, you will write 
APING in the nght column on the 7TPNAME? line. Then in Figure 87 on 
page 122, you will type APING on the CM/2 screen that looks like this: 


TP name: ?TPNAHE? 
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Also, in Figure 91 on page 124,. you will type APING on the CM/2 screen that 
looks like this: : 


Transaction Program (TP) name : 2? TPNAME? 


Symbol How to determine the value for this symbol Fill in value 
3 | here 


Values that must match with other places 


?7LUNAME? 


This is the symbol that refers to the LU name of the machine 
_you are defining to the network. 1 to 8 character field consisting 
of alphanumeric characters which 1s the LU name of the node. 

Choose a name that 1s unique within the same network name. 
An LU name 1s defined by defining a CPNAME in OS/2. Refer 
to 1.10, “How do I Configure a Network?” on page 7 for more 
information about LU names. 


2?CPNAME? 


This is the symbol that refers to the Control Point name of your 
machine. It should be the same as your 7LUNAME?. Refer to 
1.9, “What Is APPN?” on page 6 for more information about 

control points. 


2NETWORK? 


This is the symbol that refers to the network name of the 
machine you are defining to the network. 1 to 8 character field 
consisting of alphanumenic characters. There is a structured 
format for the network name which includes the country code, 
enterprise code and network suffix code. This format insures 
uniqueness around the world. Call your local IBM branch office 
for the format information and to register your network name. 
Refer to 1.10, “How do I Configure a Network?” on page 7 for 
more information about network names. 


?PARTNERLU? 


This is the symbol for the partner’s LU name. Refer to the 
“How to find...” section of the partner computer’s configuration 
chapter for this value. Refer to 1.10, “How do I Configure a 
Network?” on page 7 for more information about the partner 
LU name. 


?PARTNERCP? This is the symbol for the Control Point(CP) name of your 
partner. Refer to the “How to find..” section of the partner 


computer’s configuration chapter for this value. 


This is the symbol for the network name of the partner com- 
puter. Use the network name from the partner computer’s “How 
to find...” section. | 


This is the symbol for VTAM’s PU name. See your host plat- 
form’s instructions to determine your PU name. 


?PARTNERNET? 


?7LOCALPU? 


2LANADDRESS? 


This is the symbol for the LAN Address of the partner com- 
puter. (Or the LAN Address of a network node, if the link is 
being made to a network node.) Refer to the “How to find...” 
section of the partner computer’s configuration chapter for this 
value. 
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Symbol How to determine the value for this symbol Fill in value 
here 


JTPNAME? This is the Transaction Program name. It is a name that is sent 
across the network to the server machine. The server machine 
then maps this TP Name to an executable program. The TP 
Name is usually specified in a client/server product’s documenta- 
tion. For APING, the TP Name on the server is APINGD. 


This is the fully-specified path and filename of the transaction 
program ’s executable code. For example, if OS/2 1s installed on 
the C:\ drive, this value could be: 

C:\OS2\SAMPLES\APING\APINGD.EXE 


This is the symbol for the mode name. See 1.6, “What Is a 
Mode?” on page 5 for a discussion of modes. Often, a 
client/server product’s documentation specifies what mode must 
be used by that product. APING can use any mode (this can be 
specified on the APING command line), but the default is 
#INTER. It is recommended that you use one of the architected 
modes discussed in the “What Is a Mode?” section. 


7PTPPATH? 


Local values 


INODETY PE? This is the symbol for the APPN node type. This should be EN 
to be configured as an end node, or NN to be configured as a 


network node. In most cases, you will configure as a EN. 


This is the symbol for the Local LU Alias. 1 to 8 characters that 
designates a nickname for the Local LU. Alias names are case 
sensitive. 


?LUALIAS? 


?PLUALIAS? 


This is the symbol for the Partner LU Alias. 1 to 8 characters 
that designates a nickname for the Partner LU. Alias names are 
case sensitive. 


This it the symbol for the link name of a logical link. 1 to 8 
letters or numbers which will be used as a local name on the 
OS/2 machine to refer to the link to a partner computer. You 
can choose any name you like, but since you will use this name 
later to refer to this link, choose a meaningful name. 
(suggestion: LINK001) | 


This is the symbol for the CPI-C side information symbolic des- 
tination name. It is any 1-8 character name you choose. It will 
be used locally on the OS/2 machine to refer to a CPI-C side 

information entry. 


2LINKNAME? 


2S YMDEST? 


9.4 Working with CM/2 
_ The terms used to maneuver through CM/2 screens are described below 


¢ Select - place mouse pointer on desired item and click with left mouse button. 
The screen will not change when clicked as this is simply a selection pointer. 


« Mouse click - place mouse pointer on desired item and click with left mouse 
button. Screen data will be processed when clicked. 
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¢ Double-mouse-click - place mouse pointer on desired item and double-click the 
left mouse button. Screen data will be processed. 


9.4.1 Starting/stopping APPC | | 
APPC can be started and ended by starting and stopping CM/2. To start or stop 
CM/2, double-mouse-click on the ‘Start CM/2’ icon. To stop CM/2, double- 
mouse-click on the ‘Stop CM/2’ icon. icons respectively. 


9.4.2 Other commands : 
¢ Displaying logical links: double-mouse-click on “CM/2 Subsystems”, then click 
on “SNA Subsystems”, then double-mouse-click on “Logical links” to display 
the logical links. You can also use this screen to activate and deactivate links by 
mouse-click on “Link” on the action bar and mouse-click on the “Activate” or 
“Deactivate” action item. 


¢ Displaying active configuration: Double-mouse-click on “CM/2 Subsystems”, 
then double-mouse-click on “SNA Subsystems”, then double-mouse-click on 
“Display active configuration” to display active configuration information. You 
can instead type “PMDSPLAY” from an OS/2 command prompt. 


¢ APPNV.CTL: This file serves two purposes. It gives a descnption of the node 
definitions file and the format of the configuration verbs that can be placed in 
this file. This file also defines the command, parameter, and value names that 
are allowed in the node definitions file. 


9.5 Configuration 


9.5.1 Working with APPC configuration 


The following configuration steps will be discussed: 
1. Define yourself to the network 
2. Define a link to a partner or intermediate node 
a. Additional LEN configuration 
b. Other link configuration 
3. Configure to run as a client 
a. Define CPI-C side information 
b. Other client configuration 
4. Configure to run as a server 
a. Define transaction programs 


b. Other server configuration © 


There are two ways to configure APPC/APPN: 
¢ CM/2 Panel Configuration 
° Text editing a CM/2 Node Definitions File (NDF) 
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The Panel Configuration facility accomplishes the same function as text editing the 
NDF file and adding the configuration statements. This chapter will discuss both 
CM/2 Panel Configuration and CM/2 NDF file editing. 


Your NDF file 1s located in the \CMLIB directory. It has the same filename as 
your Communication Manager configuration file which has a file extension of 
“,CFG”. The NDF file has the file extension ”.NDF”. 


There are example NDF and CFG files. These files are provided with the CM/2 
Configuration Guide files. If you want to configure a machine from scratch, copy 
the BASE2.NDF and BASE2.CFG files into the \CMLIB directory. If you want to 
modify an existing configuration, do not copy the BASE2 files. You can, however, 
cut and paste the verbs needed from the BASE2.NDF file to your own NDF file. 
The NDF File Configuration instructions in this chapter show what commands and 
parameters should be in the NDF file. 


If you want to use CM/2 Panel Configuration, follow the Panel Configuration 
instructions. This method will place the correct commands in your NDF file. 
Follow this panel sequence to enter the CM/2 Configuration Setup. 


1. Double-mouse-click the “‘CM/2 Setup’ icon in the Communications Manager/2 
folder. 


2. Mouse-click on ‘OK’ 
3. Mouse-click on ‘Setup’ 


4. Type desired configuration file name and mouse-click on OK. This configura- 
tion file name will be “BASE2’ if you are using the configuration files provided 
with the CM/2 Configuration Guide files. 


5. Select “Token-ring or other LAN types’ from Workstation Connection Type 
column. Select “APPC APIs’ from Feature or Application type column. 
Mouse-click on ‘Configure’ 


You now have a list of the profiles that need to be configured for APPC. 


9.5.2 Define yourself to the network 
Before a CM/2 can communicate in a network, it must define itself to the network. 
This is usually done during installation. 


9.5.2.1 Panel configuration: 
You can define (or find if it is already configured) your LU name in the Local Node 


Charactenstics panel. 


To define or view your local LU name, follow this sequence of panels: 


-- Select “SNA local node characteristics" 
-- Mouse click on "Configure" to view the “Local Node Characteristics" panel 
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Local Node Characteristics 
Network ID 2NETWORK? 


Local node name ?LUNAME? 


Node type 


o End Node to Network Node Server 
o End Node - No Network Node Server 
o Network Node 
Your network node server address: ?LAHADDRESS? 


Local Node ID 


Figure 77. Local Node Characteristics. This screen displays the Local Node character- 
istics. The LU name is the Local node name on this screen. The Node Id is the 
Local Node ID. : : 


Fill in the highlighted parameters as determined for the CM/2 Configuration Work- 
sheet at the beginning of the chapter. 


Mouse-Click on “Options...” to proceed to Local Node Options panel and fill in the 
?LUALIAS? from the CM/2 Configuration Worksheet. 


Optional Features 


Local Node Alias Name ?LUALIAS? 

Maximum Compression Level 

Haximum Compression Tokens 

Optional Comment Configuration is Fun! 


Activate Attach Manager at start up 


Figure 78. Local Node Options. This screen displays the Local Node Options. The local 
LU alias is the Local Node Alias Name on this screen. 


Mouse-Click on “OK” to go back to Local Node Charactenstics panel. 
Mouse-Click on “OK” to go process data. 


Notes: 


1. If you choose the End Node to Network Node Server and fill in the network 
node address, a connection will automatically be configured to your network 
node and you can skip the “Define a link to a partner or intermediate node” 
step. | 
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9.5.2.2 NDF file Configuration: 
1. Define LU name 


You can define (or find if it is already configured) your LU name using the 
DEFINE LOCAL CP command in the Node Definitions File excerpt. A 
portion of the BASE2.NDF file is shown in the figure below. 


define _local_cp 

fq_cp name(??NETWORK?.2LUNAME) 
cp_alias(mylu) 

node_id(x’00000’) 
node_type(?NODETYPE?); 


Figure 79. NDF file excerpt from BASE2.NDF for DEFINE _LOCAL_ CP. 


2. Define Node Type 
OS/2 can be either an end node or a network node. 
¢ end node - Fill in “EN” for NODETYPE? 
"© network node - Fill in “NN” for 7NODETYPE? 


9.5.3 Define a link to a partner or intermediate node 
A link is configured by defining a ‘connection’ via the panels or a ‘logical link’ in the 
NDF file. 


9.5.3.1 Panel configuration: 
1. To define a link to a partner, or to an intermediate node, follow this sequence 
of panels: 


-- Select "SNA Connections" 
-- Mouse-Click on "Configure" to view the “Connections List" panei 
2. Select the type of node you are connecting to: 
* network node - choose “to network node” 
¢ end node or if you are unsure of partner node type - choose “to peer node” 


¢ host node - choose “to host” 


3. Mouse-Click on “Create” to view the “Adapter List” panel 


4. Select the type of data link connection you desire (e.g. Token-mng or other 
LAN types) 


5. Mouse-Click on ‘Continue’ to view the creating connection panels: 


6. Substitute the highlighted parameters with the appropnate values from the 
CM/2 APPC Configuration Worksheet at the beginning of this chapter. 
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Connection to a Network Node 


Link Name ?LINKHAME? 0 Activate at Startup 


LAN destination address (hex) Address Format Remote SAP 
?LAHADDRESS? Token Ring 


Adjacent Node ID(hex) 


0 Use this network node connection as your preferred network node server 
0 Solicit SSCP-PU Session 


Optional comment 


Figure 80. Create a Connection to a Network Node. This screen displays the parameters 
that need to be defined for connecting to a network node. 
Notes: 


1. The “Solicit SSCP-PU Session” is checked when your network node 1s the 
gateway to a host. 


Connection to a peer node 
Link Name ?LINKNAME? 0 Activate at Startup 


LAN destination address (hex) Address Format Remote SAP 
?LANADDRESS? Token Ring 


Adjacent Node [D(hex) 


Partner network ID ?PARTNERNET? 
Partner node name 2PARTNERLU? 


Optional comment 


Figure 81. Create a Connection to a LEN. This screen displays the parameters that need 
to be defined for connecting to a peer node. 
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Connection to a Host 


Link Name ?LINKHAHE? O Activate at Startup 
Local PU name 2LOCALPU2? (see Note #1) O APPN support (see note #4) 
Node ID (hex) 2HODEID? (see note #2) 


LAN destination address (hex) Address Format Remote SAP 
?LANADDRESS? Token Ring 


Adjacent Node ID(hex) 

Partner network ID ?2?PARTNERNET? 

Partner node name ?PARTHERCP? (Required for partner 

LU definitions) 


0 Use this host connection as your focal point support (see note 43) 


Optional comment 


Notes: 


1. The 7LOCALPU? name should match the PU name in VTAM but this parameter 
should not be the same as the 7?PARTNERCP? (or ?PARTNERLU?) name. 


2. See Appendix A, “Using Node IDs in VTAM” on page 143 for information 
on when to use the 7NODEID? parameter. 


3. Check this box when you want this host connection to be the focal point. 


4. Check this box when the host you will be connecting to supports CP-CP sessions. 


Figure 82. Create a Connection to a Host. This screen displays the parameters that need 
to be defined for connecting to a host node. 


9.5.3.2 NDF file Configuration 
Define a link to the network node: To define a link to your network node, your 
Node Definitions File must contain a “define _logical_link” command, as shown in 
the example below. 


define_logical_link 
link name(?LINKNAME?) 
adjacent_node_type(learm) 
preferred_nn_server(yes) 
dic_name(ibmtmet) 
adapter_number(0) 
destination_address(?7LANADDRESS””) 
cp_cp_session_support(yes) 
activate_at_startup(yes); 


Figure 83. NDF file excerpt from BASE2.NDF for DEFINE_LOGICAL LINK for 
network node link.. : 
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Define a link directly to your partner or to a LEN node.: To define a link directly 
to your partner, your Node Definitions File should contain a “define_logical link” 
command, as shown in the example below. 


define logical link 
link name(?7LINKNAME?) 
fq_adjacent_cp name(?PARTNERNET?.2PARTNERLU?) 
adjacent_node_type(learn) 
dilc_name(ibmtmet) 
adapter_number(0) 
destination_address(7 LANADDRESS?’) 
cp_cp_session_support(no) 
activate _at_startup(no); 
solicit_sscp_session(no); 


Figure 84. NDF file excerpt from BASE2.NDF for DEFINE LOGICAL LINK for 
partner link. 


When defining a link to a host LEN node that requires 3270 sessions, the following 
define_logical link parameter must be changed to yes. 


solicit_sscp_session(yes); 


Also, to configure 3270 sessions the 7 _LANADDRESS? must match the Destination 
Address in 3270 Feature Profile Connections. 


9.5.3.3 Additional configuration for LEN nodes. 
| When the partner LU 1s not accessible through a NN, as in a LEN node connection 
or a direct link to your partner, the following additional configuration must be done. 


For your machine to be able to locate the partner LU, a correlation between your 
link definition and the partner LU must be established. This is done by associating 
the partner LU to a particular link. 


Panel configuration: To add partner LU definitions for LEN nodes, follow this 
sequence of panels: 


-- SNA Connections , 
-- Select Link Name defined above for the host or LEN connection 
-- Mouse click on “Change” to view “Adapter List" panel 
-- Select DLC type defined above for the host or LEN connection 
-- Mouse click on ‘Continue’ to view “Change a connection to a Host" pan 
-- Mouse click on Define Partner LU's to view “Partner LU" panel 
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To add a Partner LU, enter the LU name, alias, and comment. Then select Add. 


To change a Partner LU, select an LU from the list, change the LU name, 
and/or comment fields, and select the Change button. 


To delete a Partner LU, select an LU from the list and select Delete. 


LU name 


Network ID: 2NETWORK? 
LU name: ?2?PARTNERLU? 
Alias: 2PLUALIAS? 


Dependent partner LU 
0 Partner LU is dependent 
Uninterpreted name 


Optional Comment 


Figure 85. Partner LU. This screen displays the parameters that need to be defined for a 
partner LU. 


Mouse-click on “Add” to add the Partner LU definition. 


NDF file Configuration: 


define_partner_lu 
fq partner lu_name(?PARTNERNET?.2PARTNERLU?) 
description(partner lu for appc on the host) | 
partner_lu_ahas(?PLUALIAS?) 
partner_lu_uninterpretred_name(?7PARTNERLU?) 
max_mce ll send_size(32767) 
conv_secunty_verification(NO) 
parallel_session_support( YES); 


define_partner_lu_location 
fq partner lu_name(?PARTNERNET?.2PARTNERLU?) 
wildcard_entry(NO) 
fq_ owning cp_name(?PARTNERNET?.2PARTNERCP?) 
local_node_nn_server( NO); 


Figure 86. NDF file excerpt for DEFINE_PARTNER_LU and 
DEFINE_PARTNER_LU_LOCATION.. 
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9.5.4 Configure to run as a client 


9.5.4.1 Define CPI-C side info entry 
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APING and many other applications do not require CPI-C side information. 


If you wish to use a symbolic destination name as the target of a conversation, 
define a CPI-C side info entry. 


Panel Configuration: To define CPI-C side information, follow this sequence of 
panels: 


-- SNA Features - 
-- Mouse-Click on "Configure" to view "SNA Features" panel 
-- Select CPI-C Communications Side Info 
-- Mouse-Click on “Create" to view “Create CPI-C" panel 


CPI Communications Side Information 
Symbolic destination name ?SYHMDEST?. 
Partner LU 


o Fully qualified name ?PARTHERHET 2. 2PARTNERLU? 
o Alias ?PLUALIAS? 


Partner TP 


_ Service TP 
TP name 2T PHAME? 


Security Type Mode name 


o Same o None o Program ?MODE? 


Optional Comment 


Figure 87. CPI-C Side Info. This screen displays the parameters that need to be defined 
for a CPI-C Side Information entry. 


NDF File Configuration: To define a CPI-C side info entry, your Node Definitions 
File must contain a “define_cpic_side_info” command, 


define_cpic_side info symbolic destination _name(?SYMDEST?) 
fq_partner_lu_name(?PARTNERNET?.2PARTNERLU?) 
mode_name(?MODE?) 
tp_name(??7TPNAME?); 


Figure 88. NDF file excerpt for defining a CPI-C side info entry.. 
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9.5.4.2 Other Client Configuration 
Define Partner LU Alias: An additional feature of defining partner LUs is that you 
can provide an alias for the actual partner LU name. For example, you could 
define “SERVER” to be an alias for 7PPARTNERNET.PARTNERLU?. Aliases are 
case sensitive; “SERVER” 1s a different alias from “server.” 


You may choose to define partner LUs, either 
1. to provide an alias for use when running a client program or 


2. to restrict the names of partner clients that can contact you. 


~ 


Panel configuration: To define a partner LU alias, follow the below sequence of 
panels: 


-- SNA Connections 
-- Select Link Name: defined above for the host or LEN connection 
-- Mouse click on 'Change' 
-- Select DLC type defined above for the host or LEN connection 
-- Mouse click on '‘Continue' 
-- Mouse click on Define Partner LUs 


Partner LU 


Fully Qualified 
LU name ?PARTNERNET?. 2PARTHERLU? 
Alias ?PLUALIAS? 


0 Conversation security verification 
Dependent partner LU 


0 Partner LU is dependent 
Uninterpreted name 


Optional comment 


Figure 89. Partner LU. This screen displays the parameters that need to be defined for a 
partner LU and partner LU alias. 


NDF File Configuration: 


define_partner_lu 
fq_partner lu_name(?7PARTNERNET?.2PARTNERLU?) 
partner_lu_alias(7PLUALIAS?,?plualias?); 


Note: Because the PLU Alias is case sensitive, you should 
define the PLUALIAS both in upper and lower 
case. This can only be done in the NDF file as shown in the example above. 


Figure 90. NDF file excerpt for Partner LU.. 
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9.5.5 Configure to run as a server 


9.5.5.1 Define transaction programs 
To run CM/2 as the server, you must, in addition to the common configuration 
steps above, define a transaction program on your machine that will be the target © 
program of conversations that will be started by client programs. 


Panel configuration:: To define a transaction program, follow this sequence of 
panels: 


-- SNA Features 
-- Mouse-click on "Configure" to view "SNA Features" panel 
-- Select “Transaction program definitions" 
-- Mouse-click on “Create” to view "Create a IP" panel 


Transaction program definition 


0 Service TP 
Transaction Program (TP) name ?T PHAME? 


0S/2 program path and file name ?TPPATH? 


Optional comment 


Optional values: 
0 Conversation security required 
Program parameter string see note 1 below 


Icon path and file name 


Figure 91. TP definition. This screen displays the parameters that need to be defined for a 
transaction program definition. 


NDF File Configuration: To define a transaction program to your network node, 
your Node Definitions File must contain a “DEFINE TP” command, as shown in 
the example below. 


define tp 
tp_name(?7TPNAME?) 
filespec(? TPPATH?) 
parm_string() | 
tp_operation(nonqueued_am_ started) 
program _type(vio_windowable); 


Figure 92. NDF file excerpt from BASE2.NDF for DEFINE_TP.. 
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Notes: 
1. Parameter string 
Enter any command line parameters that need to be run with the program. 
2. TP program operation 
This parameter indicates how the TP is started. It can be one of the following: 
¢ QUEUED_OPERATOR_STARTED 
¢ QUEUED_OPERATOR_PRELOADED 
¢ QUEUED_AM STARTED 
¢ NONQUEUVED_AM_STARTED 


9.5.5.2 Other Server Configuration 
Because CM/2 supports APPN, you do not need to define partner LU names. 


When your computer is the client, you will simply need to specify the fully qualified 
name of your partner LU. This fully qualified name includes the network name and 
LU name concatenated with a period. To enable any partner to call you when your 
computer is a server, make sure your Node Definitions File contains the following: 


define defaults 
implicit_inbound_plu_support(yes); 


Figure 93. NDF file excerpt for implicit_inbound_plu_support.. 


Note: The implicit inbound_plu_support cannot be changed from the panel config- 
uration. 


9.6 Verifying configuration 


You must verify the changes you make to the configuration by using one of the 
following methods. 


e Panel configuration: When you click on Close from the CM Setup screens the 
program will check your configuration. Answer “Yes” to “Do you want to 
update active configuration?” 


e Panel Configuration: Choose the Verify icon from the Communications 
Manager Folder 


¢ NDF Configuration - Run the following ‘appnv’ command from the OS/2 
Command prompt with the /e option to venfy and update your configuration. 
Type APPNV, then your NDF file name. 
‘cmverify < NDF file name > .NDF’ 


You should stop and restart Communications Manager to make changes active. 
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9.7 Running APING 


To venfy configuration between two computers, run APING from the OS/2 
Command prompt with the following parameters: 


¢ Parameter = ?PARTNERNET?.22PARTNERLU? or ?PLUALIAS? or 


?SYMDEST? 
¢ Options = Any options flags you wish to run with APING. Type ‘APING 7” 
for list. 


APING ?PARTNERNET?. ?PARTNERLU? 


9.8 How to find... 


9.8.1 Panel Configuration 
¢ LU name 


You can find your local LU name in the Local Node Charactenistics by fol- 
lowing the following sequence of panels: 


-- Select “SNA local node characteristics" 


-- Mouse click on "Configure" to view the “Local Node Characteristics" panel 


The LU name is the Local Node Name on the panel. 
« CP name | 

The CP name is the same as the LU name found above (Local Node Name). 
¢« Network Name 

The Network Name is the Network ID in the Local Node Characteristics panel. 


¢ local LAN address - the local LAN address cannot be found by the CM/2 
panels. 


9.8.2 NDF File 


¢ LU name 


You can find your LU name in the DEFINE_LOCAL CP command in the 
following Node Definitions File excerpt: 
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define _local_cp 
fq_cp_name(?7NETWORK?.2LUNAME?) 
cp_alias(mylu) 

node_id(?7NODEID?) 
node_type(?7NODETYPE?); 


Figure 94. NDF file excerpt from BASE2.NDF for DEFINE_LOCAL_CP.. 


The LU name is LUNAME. 
e CP name 

The CP name 1s the same as the LU name found above. 
e Network Name 


The Network Name is the 7?PARTNERNET? in the excerpt of the 
DEFINE LOCAL_CP command. 


¢ local LAN address 


The LAN address is a 12-digit hexadecimal value that identifies your token-nng 
adapter to the network. There is a LAN address hard-coded on the Token- 
Ring adapter in the CM/2 machine. This hard-coded value is sometimes be 
over-nidden with something called a “locally administered address.” You can 
find your LAN address in the following ways. 


— Check the computer's \IBMCOM\LANTRAN.LOG file. You will see a 
line that says: 


Adapter X has node address ‘(LANADDRESS’. The value in 
LANADDRESS is your local LAN address. 


— Run diagnostics on the computer’s reference diskette: 
1. Boot the machine on its reference diskette 
. Press Enter to clear the main panel 
. Press Ctrl+ A to start advanced diagnostics 
. Select “System checkout” 
. Press “Y” to indicate the list 1s correct 
. Select “Run tests one time” 
. Cursor down to the “Pnmary Token-Ring Adapter” and press Enter 


. Select the proper cable type 


Oo CO YN DWN OW FR W NN 


. Press enter on the panel asking you to disconnect your cable (you don't 
actually need to disconnect it for this exercise) 


10. Press enter when told the next screen will contain important informa- 
tion 


11. On the information screen, the value after Adapter Address is your 
LAN address (you may need to Page Down to see this value). 
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12. After making note of the Adapter Address, remove the reference 
diskette, reconnect your cable if you disconnected it, and press Ctrl-Alt- 
‘Delete to reboot your machine. 
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10.0 APPC/VM Configuration 


This chapter describes how to configure APPC/VM. The configuration is spread 
among the APPC/VM VITAM Support service machine (AVS), VTAM, and NCP. 
Examples of configuration of each are shown. 


10.1.1 Prerequisites 
Software and hardware prerequisites for our chapter examples of APPC/VM 
include: 


« VM/ESA V1.0 or later 

¢ VITAM V3.3 or later 

¢ NCP V5.2 or later 

¢ 3745 with Token-ring attachment 
¢ Single SNA domain. 

It also assumes that the software listed above has already been installed on the 

appropnate hardware platforms. 

For more detailed information on APPC/VM configuration and operation refer to: 
¢ VALjESA Connectivity Planning, Administration, and Operation, SC24-5448 
¢ VTAM Resource Definition Reference, SC31-6438 
¢ NCP Resource Definition Reference, SC30-3448 


10.2 Terminology 


The terminology table maps the standard networking terms defined in 1.10, “How 
do I Configure a Network?” on page 7 to the terms used by APPC/VM. 


Standard Term APPC/[VM Term 
Network Name NETID 


LU Name name supplied for APPL definition in 
APPL major node 

Partner LU Name | name supplied for LU definition in 
major nodes other than APPL 

Local LAN Address | LOCADD (in NCP gen) 


Adjacent LAN Address DIALNO (on PATH definition in 
switched major node) 
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10.3 APPC/VM Configuration Worksheet 


Use the following worksheet to determine all the values you will need to configure 
this platform. The worksheet is split into two parts: values determined by referring 
to the Guide introduction or other platform chapters, and values that are local to 
this platform which you create. There are three columns. The left-most column 
has a variable name that starts and ends with a question mark (?), the middle 
column describes what the variable is used for and how to determine its value, and 
the right-most column is left blank so you can fill in a value. Whenever there is a 
reference in this chapter to a value in the left column, substitute the value you have 
written in the nght column. | 


Symbol How to determine this value Fill in value 
here 


Values that much match with other places 


?LOCALLU? This 1s the symbol that refers to the LU name of the machine : 


you are defining to the network. 1 to 8 character field consisting 
of alphanumeric characters which is the LU name of the node. 
Choose a name that is unique within the same network name. 
Refer to 1.10, “How do I Configure a Network?” on page 7 for 
more information about LU names. 


You may already have an LU name defined. If so, it 1s the value 
specified in an “AGW ACTIVATE GATEWAY’ command. 
This command can be included in the AGWPROF GCS exec of 
the AVS service machine, or it can be issued from the AVS 
console. 


You may also have more than one LU. There are two major 
types of gateways in APPC/VM; global and private. If you want 
to use both you will need a minimum of one LU for each type. 
See 10.6.5, “Configure to run as a server” on page 138 for more 
information on gateways. A private gateway will be referred to by 
?7LOCALLU_P?, while a global gateway will be called 
?7LOCALLU_G?. 


VTAM pnior to V4 does not have a control point. Refer to 1.9, 
“What Is APPN?” on page 6 for more information about 
control points. | 


?7LOCALCP? 


27LOCALNET? 


_ This 1s the symbol that refers to the network name of the 
machine you are defining to the network. | to 8 character field 
consisting of alphanumeric characters. There is a structured 
format for the network name which includes the country code, 
enterprise code and network suffix code. This format insures 
uniqueness around the world. Call your local IBM branch office 
for the format information and to register your network name. 
Refer to 1.10, ““How do I Configure a Network?” on page 7 for 
more information about network names. 


For systems with VITAM already configured, this value is found 
in the VTAMLST start options (ATCSTRxx) member. The 
option name is NETID. 
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Symbol How to determine this value Fill in value 
here 


?PARTNERLU? This is the partner’s LU name. Refer to the “How to find...” _ 


section of the partner computer’s configuration chapter for this 


value. Refer to 1.10, “How do I Configure a Network?” on 
page 7 for more information about the partner LU name. 


This is the symbol for the LAN Address of the partner com- 
puter. (Or the LAN Address of a network node, if the link is 
being made to a network node.) Refer to the “How to find...” 
section of the partner computer's configuration chapter for this 
value. | 


27LANADDRESS? 


JTPNAME? 


This 1s the symbol for the Transaction Program name. This is 
the name of the transaction program at the partner computer. 
For APING, the TP Name on the server 1s APINGD. 


When using private gateways, an entry is made in the 
$SERVERS$ NAMES file that maps the TP name to an EXEC 
or module. The actual TP name follows a *:nick.” parameter in 
the file. 


This is the symbol for the mode name. See 1.6, ‘““What Is a 
Mode?” on page 5 for a discussion of modes. Often, a 
client/server product’s documentation specifies what mode must 
be used by that product. APING can use any mode (this can be 
specified on the APING command line), but the default is 
HINTER. It 1s recommended that you use one of the architected 
modes discussed in the “What Is a Mode?” section. 


2MODE? 


Local values 


INCPLANADDR?| This is the local LAN address coded in NCP on a LINE macro 
using the LOCADD parameter. 


2MODETAB? Name of a logon mode table in VTAM. It is assembled and link- 
edited into a VTAM LOADLIB dataset. The systems pro- 
grammer should know the names of the logon mode tables 
defined on the system. This should be the name of the table 
where the APPC modes are included. 


2S YMDEST? This is the CPI-C side information symbolic destination name. 
It is any 1-8 character name you choose. It is included when 

creating a side information entry. The side information is stored 
in communications directory files which are sumilar to NAMES 


files. 


10.4 Working with APPC/VM 
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10.4.1 Starting/stopping APPC 


APPC/VM is usually started by autologging the AVS/VM virtual machine. It can 
also be started by issuing AGW START once GCS is ipled in the AVSVM 
machine. Stopping APPC/VM is accomplished via the AGW STOP command. 


40.5 Other commands 


_APPC/VM is a VTAM application that runs in its own disconnected virtual 


machine (typically AVSVM) under GCS. Once APPC/VM is logged on there are 
several commands that can be used to monitor its operation. A subset of these com- 
mands is shown below: 


AGW QUERY ALL 


AGW CNOS 


AGW ACTIVATE GATEWAY 


The QUERY ALL command provides a listing of all resources in use by | 
APPC/VM. AGW CNOS will negotiate session limits with partner LUs. ACTI- 
VATE GATEWAY makes an LU available to APPC/VM for its own use. 


10.6 Configuration 


10.6.1 Working with APPC configuration 
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The following configuration steps will be discussed: 
1. Define yourself to the network 
2. Define a link to a partner or intermediate node 
a. Additional LEN configuration 
b. Other link configuration 
3. Configure to run as a client 
a. Define CPI-C side information 
b. Other client configuration 
4. Configure to run as a server 
a. Define transaction programs 


b. Other server configuration 


For APPC/VM, configuration is done in the following places: 
¢ AVSVM DIRECT - The directory entry for APPC/VM. 


¢ AGWPROF GCS - This exec is called by AVSVM during nae It starts 
resources for AVS/VM. 


¢ Server commands - Certain commands are issued in any virtual machine that 
will be used as a server. 


¢ COMDIR - For client virtual machines, the communications directory must be 
established for CPI-C applications with the SET COMDIR command. 
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¢ $SERVER$ NAMES - For server virtual machines, this file contains the 
mapping of transaction program names to executables. It is used only with 
private gateways. 


¢ VTAM - Definitions are required in an application major node for the 
APPC/VM LU or LUs, as well as partner definitions in a switched major node 
for LAN attached T2.1 nodes, such as workstations. Additions are also need in 
logon mode tables for APPC modes. 


« NCP - The token-ring adapter must be configured, and a parameter added to 
the NCP definition to support independent LUs. 


10.6.2 Define yourself to the network | 
1. Create CP Directory Entry for the APPC/VM VTAM Service Machine 


APPC services in VM access an SNA network through the APPC/VM VTAM 
Service Machine (AVSVM). AVSVM’s directory entry should look similar to 
the one shown below: 


USER AVSVM AVSVM 32M 64M G 64 

ACCOUNT 1 AVSVM 

MACH XA 

IUCV ANY 

TUCV *IDENT GATEANY ?LOCALLU? REVOKE 
TUCV ALLOW 

OPTION COMSRV MAXCONN 20 ACCT 
NAMESAVE GCS 

IPL GCS PARM AUTOLOG 

CONSOLE O1F 3215. 

SPOOL QQC 2540 READER A 

SPOOL 00D 2540 PUNCH A 

SPOOL QOE 1403 

LINK MAINT 190 190 RR 

LINK MAINT 19D 19D RR 

LINK MAINT 19E€ 19E RR 

LINK MAINT 193 193 RR 

MDISK 191 3380 2209 003 SSKNOS MR RAVSOBJ WAVSOBJ MAVSOBJ 


* 


Figure 95. CP Directory Entry for AVSVM - AVSVM.DIR 


2. Load AVS from the Product Tape 


This step is described in the VM/ESA Installation Guide, SC24-5526. It is done 
by issuing the command: 

vmfins install ppf esains avs (nomemo nolink 

It 1s strongly recommended in the VM/ESA Installation Guide that none of the 


disk addresses in the user directory be modified. The directory entry shown 
above is the entry shipped with VM/ESA. 


The example above 1s for installation on mini-disks. It may be advantageous to 
install AVS in the shared file system (SFS). For more information on this, see 
both the VM/ESA Installation Guide and VM/ESA: CMS Planning and Admin- 
istration Guide, SC24-5445. 


3. Create the AVS Virtual Machine Profile and AGWPROF GCS. | 


The PROFILE GCS contains commands to start AVS when the virtual 
machine is started. It is stored on the AVS 191 disk. AGWPROF GCS is 
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called after AVS initialization, and contains commands to execute as soon as 
AVS is available. Samples of each are shown below. 


LAA EE REAR EL EAS RA ERROR One eae RAR een nea Ren ce ne Rn 


/* ee 
/* SAMPLE PROFILE GCS FOR AVS 3 
* 


* 


[RAR SEEAAA SASS AES EAEE LESSER EARS EAT SAREE SEERA EDS LS RRA S RON NA LE Se | 


Trace 0 

'CP SET IMSG ON' 

'CP SET EMSG ON' 

'CP SET RUN ON' 

'CP SET PFO1 IMMED AGW QUERY ALL' 

'CP SET PFO2 IMMED AGW QUERY GATEWAY ALL' 

'CP SET PFO3 IMMED AGW QUERY CNOS ALL' 

'CP SET PFO4 IMMED AGW QUERY USERID ALL' 

'CP SET PFOS IMMED AGW QUERY CONV ALL' 

'CP SET PF12 RETRIEVE’ 

f REA E AT CRORE RG ER MT TN Oa Se Ratan ape S OR Oe nee ee 
? “/ 
/* Determine mode of operation. Load AGW370 loadlib if running */ 
/* in 370 mode. Load AGW LOADLIB if running in XA mode. . 


[PERE REEE RE EERE RRND CUR ORM Seer OP RR None OMe Sr mR ea a Sey en aster 


'GLOBAL LOADLIB AGWUTIL' /* Contains AGWGMD e/ 
'OSRUN AGWGMD' /* AGWGHD returns 0 if running in XA mode, 
and 4 if running in 370 mode ey 
IF RC=0 THEN /* Virtual machine is in XA mode ef 
'GLOBAL LOADLIB AGW' 
ELSE 
'GLOBAL LOADLIB AGW370' /* Virtual machine is in 370 mode gy 
'LOADCMD AGW AGW 
'Q LOADLIB' 
'Q LOADCMD' . 
‘AGW START! /* Start AVS =] 
exit rc 


Figure 96. PROFILE GCS - PROFILE.GCS 


LE RET SESAME E ARE ey, 


/* AGWPROF GCS FOR AVS */ 


aaa cal hal cada ol | 


"AGW ACTIVATE GATEWAY 2LOCALLU_P? PRIVATE' 
"AGW ACTIVATE GATEWAY 2?LOCALLU_G? GLOBAL' 


Figure 97. AGWPROF GCS - AGWPROF.GCS 


Notes: 


a. The names substituted for 7 LOCALLU? should be different. 7 LOCALLU? 
was used to designate both since they are both local LUs. 


Gateways define paths (Logical Units or LUs) into the SNA network. As such 
these names must match names of LUs defined in a VTAM application major 
node described below. 


4. Create VTAM Application Major Node 
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Place the following in a VTAMLST library (usually SYS1.VTAMLST): 


* 


APLAVS VBUILD TYPE=APPL 

?LOCALLU_G? APPL APPC=YES, 
AUTHEXIT=YES, 
AUTOSES=1, 
DSESLIM=8, 
DMINWNL=4, 
DMINWNR=4, 
PARSESS=YES, 
SYNCLVL=CONFIRM, 
SECACPT=ALREADYV 

?LOCALLU_P? APPL APPC=YES, 
AUTHEXIT=YES, 
AUTOSES=1, 
DSESLIM=8, 
DMINWNL=4, 
DMINWNR=4 
PARSESS=YES, 
SYNCLVL=CONFIRM, 
SECACPT=ALREADYV 


Figure 98. VITAMI definition of APPC LU - APPLVM.VIM 


Notes: 


a. The names substituted for 72LOCALLU? should be different. 7LOCALLU? 
was used to designate both since they are both local 


b. If a logon mode table other than the default table ISTINCLM) will 
contain the APPC mode entries, a MODETAB parameter should be added 


to the entnes above. LUs. 


c. Depending on security requirements on the VM system, the SECACPT 


parameter may also need to be changed. 


5. Add APPC Modes to the Logmode Table 


APPC modes are shown in Figure 99 on page 136. Add them to your logmode 


table, compile, and then link-edit the member into a VTAM library. Also 
include them in the default logmode table (ISTINCLM) so that dynamically 


created LUs can use them. 
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KRAKKKKKKKKEKKKKKKEKKKEKAKKKREKKKKEREREKKRKKKKKEKEKKEKRKEEREKEKKKEKKKKKKKKEKKKK 


“ LOGHODE TABLE ENTRY FOR RESOURCES CAPABLE OF ACTING : 
* AS LU 6.2 DEVICES : 
KKKKKKKKEKEKKKKKKKEERKEKKEKRKKKRKKREREKKKKEKEKREKREKREKEKEREKERKKEKRKEKKKKK 
SNASVCHG HODEENT LOGHODE=SNASVCHG, FHPROF=X'13', TSPROF=X'Q7', 
PRIPROT=X'BO' , SECPROT=X'BO' , COMPROT=X'DOB1', 
RUSIZES=X'8686' , ENCR=B' 0000", SSNDPAC=7, 
PSERVIC=X'960200000000000000000300' , 
SRCVPAC=7, PSNDPAC=7, TYPE=0 
TITLE ‘#BATCH' 


KRHKEKKKKKKKKKKKKKKKKKEKKRKKKKKEKKKRKEKRKKKKKEKKKKAKKREKEEKKKKKEKEKKEKKKKKKKKKKEK 


+> + * & 


* * 
* LOGHODE TABLE FOR BATCH SESSIONS ON RESOURCES CAPABLE * 
4 OF ACTING AS LU 6.2 DEVICES i 
* * 


KAKKKKKKKKKKEKEKKKKKEKEKEKKKREKKKKKKEKREKKKKKKKKEKKKEKEKEKEKKKKKEKKKKKKEKKKKKEKK 


#BATCH HODEENT LOGMODE=#BATCH, | - 
ENCR=B '0000' , SSNDPAC=3, & 
SRCVPAC=3 , PSNDPAC=3, RUSIZES=X'F7F7' 
TITLE ‘#INTER* 


KKKKKAKAKKKKKKKKKKKKKKEAEKKKREKRKKREKKKKKEKAKKREKKREKKKREREKKKEKKEKKKKKEKKKKKKK 


* * 
J LOGHODE TABLE FOR INTERACTIVE SESSIONS ON RESOURCES . 
z= CAPABLE OF ACTING AS LU 6.2 DEVICES ’ 
* * 


KEKKKAKKKKKEKKKKKKKKKRKAKKKAKKKKKEKERKKKKKKKKKKKKKKKKKKKEKKKEKKKKKKKEKKKAKKKEKKKEKEK 


FAINTER MODEENT LOGHODE=#INTER, x 
ENCR=B'0000* , SSNDPAC=7, x 
SRCVPAC=7, PSNDPAC=7, RUSIZES=X'F7F7' 
TITLE '#BATCHSC' 


KREKKKKKKKRKKKKKKKKKKKKKKAKKKAERKKKREKRKKKKKKKEKKKKEKKEKKEKKKKKEEKKKKKKKREKEKRKAKK 


x nt 
iy LOGHODE TABLE FOR BATCH SESSIONS REQUIRING SECURE . 
s TRANSPORT ON RESOURCES CAPABLE OF ACTING AS LU 6.2 x 
* DEVICES | * 
* * 


KRAKKKAKKKEKKKKKEKKKKKAKKKKKKKKKERAKKKAKAEKKKKKKKKKKKKKKKKKEKKKKKKKKKKEKKKKKKKEK 


#BATCHSC HODEENT LOGHODE=#BATCHSC, . 
ENCR=B '0000', SSNDPAC=3, | m 
SRCVPAC=3 , PSNDPAC=3, RUS I ZES=X‘F7F7' 
TITLE '#INTERSC* 


KAKKKKKKKKKKAKRKKKKKKKKKKEKKKKKKKKKKKKEKKEEKKKKKKKKKKEKKKKKKEKEKKKKKKKRKEKKKEKKK 


* 
LOGNODE TABLE FOR INTERACTIVE SESSIONS REQUIRING . 
SECURE TRANSPORT ON RESOURCES CAPABLE OF ACTING AS = 
LU 6.2 DEVICES : 

* 


+ + & * 


PRI KIKI IK III III IRI IFHIR IIH IAI IAI IRIS III IIA AIA IIIA AAI AAA AAAI IA KA 


#INTERSC HODEENT LOGHODE=#INTERSC, e 
ENCR=B'0000' , SSNDPAC=7, * 
SRCVPAC=7, PSNDPAC=7,RUSIZES=X'F7F7' 
TITLE ‘CPSVCHG' 


KRKKKKKKKKKKKKEKKKKKKKKRKKKAKKKKKKKKKKKKKRKKEKKKKAKKRKKKKRKKKEKKKKKKEKKKERKKARKKKK 


x * 
“ LOGHODE TABLE FOR CP-CP SESSIONS ON " 
e RESOURCES CAPABLE e 
A OF ACTING AS LU 6.2 DEVICES . 
* * 


KAEKKKKKEKKKKKKKKKKKKKREEKRKEKKEKEKRKKKRKKERRKKKRKEKKKREKKKKKEKEKKKKKRKKKKKKKKEKKE 


CPSVCHG MODEENT LOGHODE=CPSCVHG, . * 
RUSIZES=X* 8686", ENCR=B'0000', i 
SSNDPAC=7, SRCVPAC=7, PSNDPAC=7 


Figure 99. APPC Logon Mode Entries - APPCMODE.ASM 
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10.6.3 Define a link to a partner or intermediate node 
1. Define the Token-nng adapter in NCP 


The following is a sample token-ring connection from NCP: 


TO30T2PG GROUP ECLTYPE=(PHYSICAL ANY) 
TO30T2PL LINE ADDRESS=(1089,FULL) , LOCADD=?NCPLANADDR? , PORTADD=2 , X 
RCVBUFC=4095 , MAXTSL=2044 , ADAPTER=T IC2, TRSPEED=4 


* 


TO30TRLO GROUP ECLTYPE=LOGICAL , AUTOGEN=10, PHYPORT=2, CALL=INOUT 
Figure 100. LAN definitions on NCP 


2. Provide for use of independent LUs on the token-nng connection 


Once the token-ring is defined in the NCP, the only additional parameter that is 
required is NUMILU on the LUDRPOOL macro. For example: 


POOL1 LUDRPOOL NUMILU=100,NUMTYP1=20, NUMTYP2=20 


In this example the NCP wiul be able to support up to 100 independent LUs 
that are being connected via dial connections (token-ring or switched lines). 


10.6.3.1 Additional LEN configuration 
Place the following in a VTAM switched major node definition. It assumes that the 
partner node is not another VITAM. If the partner LU is on another VTAM system, 
then the link definitions for the token-ring shown above need to be for a subarea 
link, or the cross-domain links need to be defined so that normal LU routing within 
the subarea network wil resolve the locations of the session partners. 


WSN VBUILD TYPE=SWNET,MAXGRP=2 ,MAXNO=2 
PARTPU PU —ADDR=04, 
CPNAME=? PARTNERLU?, 
PUTYPE=2, 
MAXDATA=2012, 
MAXPATH=1 | 
2PARTNERLU? LU — LOCADDR=0,MODETAB=?MODETAB? , DLOGMOD=?MODE? 


Figure 101. WSN.VIM 


>< >< >< OX< 


PARTNERLWU should be changed to match the partner LU name. See the “How to 
find...” section of the partner computer’s configuration chapter for this value. 


10.6.4 Configure to run as a client 
Place the APING MODULE and APINGD MODULE on a minidisk to which 
you have access. It is recommended to use a shared minidisk. 


10.6.4.1 Define CPI-C Side Information 
In APPC/VM side information is stored in what 1s called a communications direc- 
tory. Itis a VM file sumular in definition and use to VM NAMES files. Defining 
CPI-C Side Information is optional. Below is a sample entry: 


snick.2?SYMDEST2 :APINGD 
:luname.?LOCALLU? ?PARTNERLU?2 
:modename. ?HODE? 
:security.NONE 


Figure 102. Sample Communications Directory Entry - COMDIR.SMP 
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If this entry is included in a VM file called SAMPLE COMDIR then it can be acti- 
vated in the client virtual machine by issuing: 


SET COMDIR FILE USER SAMPLE COMDIR 


More information on this command can be found by looking at the online help text 
for SET COMDIR. 


10.6.5 Configure to run as a server 
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Place the APING MODULE and APINGD MODULE on a minidisk to which 
you have access. It is recommended to use a shared minidisk. | 


1. Configure the Virtual Machine to run APINGD 


There are two principle methods of execution for transaction programs in 
APPC/VM; as global resources or as private resources. A global resource can be 
thought of as a resource or program available to a number of users, while a 
private resource Or program is run within a particular users virtual machine. 
Which type is used by APPC/VM on incoming requests 1s determined by the 
type of gateway; if a global gateway is used, the transaction program 1s sched- 
uled as a global resource, while if a private gateway is used the transaction 
program is assumed to be private. Gateways are APPC/VM LUs. 


Configuring a Global Gateway: A global resource must be registered as such with 
VM. There are two ways to do this. First, an entry can be added to the directory of 
the virtual machine owning the resource, as is shown below: 


TUCV *IDENT resrcl GLOBAL 


This will identify resrcl as a resource managed by the virtual machine in which it 1s 
included. | 


The other way is to use the Identify_Resource_Manager (XCIDRM) call. This call 
can be used from within a program or EXEC to register the resource with VM. 
This still requires an additional directory entry similar to the one below: 


TUCV *IDENT RESANY GLOBAL 


The “RESANY” parameter allows the resource manager virtual machine to register 
any resource name using the XCIDRM call. Below is a sample EXEC called 
RESAPING which registers a resource called APINGD as a global resource, and 
then waits for events (such as an incoming attach) to schedule the transaction 


program. 
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for] 
/* ARG resid */ 
‘set Idrtbls 20' 
'rtnload * (FROM VHLIB SYSTEM GROUP VMLIB)' 
‘global loadlib edclink' 
‘GLOBAL TXTLIB EDCBASE IBHLIB CMSLIB CHSSAA' 
resid = word(resid userid(), 1) 
original resid = resid 
‘EXECIO * DISKR CMREXX COPY * (FINIS STEM CPICONST. ' 
if rc<>O then exit rc 
do i=1 to cpiconst.0 
interpret cpiconst.i 
end 
/* TRACE 'I' */ 
server_scope=XC_GLOBAL 
service_mode=XC_SEQUENTIAL 
secnone=XC_ACCEPT_SECURITY_NONE 
address cpicomm 
RESID=*APINGD ' 
‘XCIDRH RESIO SERVER_SCOPE SERVICE_HODE SECNONE IDSRV_RC' 
IF IDSRV_RC <> 0 & IOSRV_RC <>24 THEN 00 
SAY ‘Unable to start resource’ RESID 
exit idsrv_RC 
end 
do forever 
say ‘Waiting for ALLOCATION event, TERMINATE, STOP or CNS command’ 
‘XCWOE resid conversation_id event length buffer WOE_rc' 
select 
WHEN event=XC_ALLOCATION REQUEST then do 
address cms ‘'VHFCLEAR' 
say ‘Allocation request received for' resid 
CALL Process Request 
end 
WHEN event=XC_CONSOLE_IHPUT then 
CALL user_input left(buffer, length) 
WHEN event=XC_REVOKE_RESOURCE then do 
say ‘Resource management for‘ resid ‘has been revoked’ 
SIGNAL Terminate Server 
end 
OTHERWISE 
say 'Wait_On_ Event returned event XC_INFORHATION_INPUT' 
SIGNAL Terminate Server 
end 
end 
Process Request: 
ADDRESS COMMAND 
RESID 
RETURN 
User Input: 
arg user_buffer 
select 
WHEN USER_BUFFER = ‘STOP’ THEN DO 
say ‘Terminating because of stop’ 
exit 
end 
OTHERWISE DO 
ADDRESS CHS USER_BUFFER 
END 
end 
return 


Figure 103. EXEC to Schedule a Global Resource - RESAPING.EXC 


Configuring a Private Gateway: A private gateway runs in a user’s “private” virtual 
machine. Within that virtual machine the appropnate TXTLIB and LOADLIB 
members must be globalled to run a program such as APING that is wntten in C. 
The following EXEC gives an example of an EXEC that can be called from a user’s 
PROFILE EXEC to set up the virtual machine to act as a server: 
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/* This exec sets parameters for APPC/VM server operation */ 
PARSE ARG HELP1 
IF HELP1 = '?' THEN DO 
say 'This EXEC sets a user virtual machine for use as an APPC server. 
say ‘It:' 
say ' 1. Performs SET SERVER ON! 
say ' 2. Performs SET FULLSCREEN OFF' 
say ' 3. Performs SET AUTOREAD OFF' 
say ' 4. GLOBALs loadlib and txtlibs needed for C/370.' 
Say 
say ‘It can be called from the PROFILE EXEC to automatically enable‘ 
say ‘APPC server function. ' 
exit 0 
end 
TRACE 0 
SET CMSTYPE HT 
/* Test for existing LOADLIB defs. Add EDCLINK (C runtime) if not sf 
/* configured. ay 
‘QUERY LOADLIB (STACK LIFO)' 
PARSE UPPER PULL LLIBS 
I = WORDS (LLIBS) 


EDCADD='YES' 

LOADCMD = 'GLOBAL LOADLIB '! 

DO J=3 10 I 
IF WORD(LLIBS,J)<>'NONE' THEN LOADCMD=LOADCMD || ' ' || WORD(LLIBS,J) 
IF WORD(LLIBS,J)="EDCLINK' THEN EDCADD='NO' 

END 

IF EDCADD='YES' THEN LOADCMD=LOADCMD || ' EDCLINK' 

INTERPRET LOADCHD 

/* Test for existing TXTLIB defs. Add EDCBASE (C libraries) and a 
/* and CMSSAA (contains CPI-C routines), if necessary. my 


‘QUERY TXTLIB (STACK LIFO)' 

PARSE UPPER PULL TLIBS 

I = WORDS (TLIBS) 

EDCADD='YES' 

IBMADD='YES! 

SAAADD="YES' 

LIBCMD = 'GLOBAL TXTLIB ! 

DO J=3 10 I 
IF WORD(TLIBS,J)<>'NONE' THEN LIBCMD=LIBCMD || ' * || WORD (TLIBS, J) 
IF. WORD(TLIBS,J)="EDCBASE' THEN EDCADD='NO' 
IF WORD(TLIBS,J)="CMSSAA' THEN SAAADD='NO! 
IF WORO(TLIBS,J)="IBMLIB' THEN IBMADD='NO' 


END 

IF EDCADD='YES' THEN LIBCMD=LIBCMD || ‘ EDCBASE' 
IF SAAADD="YES' THEN LIBCMD=LIBCMD || ' CMSSAA' 
IF IBMADD="YES' THEN LIBCMD=LIBCMD || ‘ IBMLIB' 


INTERPRET LIBCMD 
'SET SERVER ON' 

'SET FULLSCREEN OFF! 
'SET AUTOREAD OFF! 


Figure 104. EXEC to Enable Server Operation - RESAPING.EXC 


Notes: 


1. The last three lines (SET commands) are required for private server operation. 
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10.6.5.1 Define transaction programs (TPs) 
When a private gateway is used, APPC/VM converts TP names received on 
ATTACHes to executable program names by mapping the TP names to entries in a 
file called $SSERVER$ NAMES. 


To add new transaction programs, edit the SSERVER$ NAMES file and add the 
following entry. 


* This file is used by APPC server to determine what module or exec 
* to call based on the TP name received in an ATTACH. 
:nick.APINGD sList. 

smodule.APINGD 


Figure 105. SSERVERS NAMES - TP To Executable Mapping - SSERVERS.NAM 


In the above example, the TP name APINGD specified in the “:nick” field is 
mapped to the exccutable. The “:list” field specifies a list of userids authorized to run 
this TP. The asterick implies that any userid may run the TP. 


If the userid on the ATTACH matches the userid of the virtual machine where the 
TP is to run, then the “:list” entry is not needed. Similarly, if the TP name received 
in the ATTACH matches the executable name then the “:module” entry is not 
required. If both of these conditions are true then the entire entry in the file can be 
omitted. 


To add other transaction programs, edit the SSERVER$ NAMES file and add the 
following entry: :nick.7TPNAME? _ :list.* 
:rmodule.?7TPNAME? 


10.7 How to find... 
e LU Name 
For APPC/VM, this 1s configured in AGWPROF GCS. The command: 
AGW ACTIVATE GATEWAY ?LOCALLU? GLOBAL 
defines a global resource manager with name 7LOCALLU?. 
¢ Control Point (CP) Name 


VTAM, being a LEN node, does not have a CP (Control Point) name for 
APPN use. It does, however, have a SSCPNAME (System Services Control 
Point Name). If in configuring a partner platform a CP name is needed, use the 
SSCPNAME instead. . It is also set in the ATCSTRxx file on the VTAM 191 
disk. 


e Network Name 


It is defined in a fille named ATCSTRxx on VTAM’s 191 disk. The “xx” is two 
digits, and the default is 00. ATCSTRxx is the VTAM start options. The 
NETID parameter defines the network name. 


e LAWN address 


The LAN address is coded in NCP on a LINE macro using the LOCADD 
parameter. 
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Appendix A. 


Using Node IDs in VTAM 


Prior to VTAM Version 3 Release 2, the only mechanism VTAM had for resolving 
dynamic connections like dial-in was the node ID. The examples in this guide all 
use a LAN connection which to VTAM is just like dial-in. The node ID is set in 
the computer dialing in and must match the value in VTAM for that physical unit. 


The node ID itself was intended to have two parts: a block number that was to be 
unique for each product type and an /D nurnber that was to be unique within each 
product type. These two parts correspond respectively to the /DBLK and [DNUM 
parameters in VTAM. 


The examples below show for each of the pertinent platforms (LEN peripheral 
nodes and APPN nodes) how to code the node ID in the platform and the corre- 
sponding VTAM definition. 


Note: Some platforms allow you to set the block number; in others it is fixed. If 
the block number is settable you can use any matching value for IDBLK in VTAM. 
If the block number is fixed and VTAM does not use the CPNAME parameter as 
recommended, then the VTAM IDBLK MUST MATCH the block number in the 
product. This will be indicated in the examples. 


Note: Although the information regarding nodeids applies to VTAM releases earlier 
than Version 3 Release 2, the configurations in this guide require function that is 
only supported in Version 3 Release 2 and later. 


A.1 Node ID for SNA Services/6000 or SNA Server/6000 


SNA Services/6000 and SNA Server/6000 allow you to set the block number; the 
default is 071. In the example below, the “bbb” values must match in VTAM and 
SNA Services/6000 or SNA Server/6000. 


PROFILE name ?CPPRO? 
XID node ID bbbnnonnn 


NETWORK name ?NETNAME? 
CONTROL POINT name = ?SSCPNAME? 


Figure 106. SNA Services;6000: Control Point profile 


Control Point name ?LOCALCP? 
Control Point type appn_end_node # see note 


Local network name ?LOCALNET? 
XID node ID * 


# see note 


Figure 107. SNA Server/6000: Initial Node Setup: Information 


The corresponding VTAM definition is as follows: 
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?LINKNAME? PU ADDR=04, X 
CPNAME=?AIXLUNAME?, X 
IDBLK=bbb, * DEFAULTS TO 071 = X 
IDNUM=nnnnn, * ANY 5 HEX DIGITS " X 


MODETAB=?MODETAB? 
?ATXLUNAME? LU LOCADDR=0,DLOGMOD=#INTER 


A.2 Node ID for AS/400 


The AS/400 calls the node id the local exchange identifier FIXES the block number 
at 056. Below is a sample screen from the Create Controller Description command. 
The controller type/class is *HOST. 


Create Ctl Desc (SNA Host) (CRTCTLHOST) 


Type choices, press Enter. 


Controller description > ?CONTRNAME? Name 

Link type *IDLC, *LAN, *SDLC, *X25 
Online at IPL *YES *YES, *NO 

APPN-capable *NO_ SYES..: > NO 

Switched line list Name 

+ for more values 

Maximum frame size *LINKTYPE 265-16393, 256, 265, 512... 
Remote network identifier .. . *NETATR_ Name, *NETATR, *NONE, *ANY 
Remote control point Name, *ANY 

SSCP identifier O50000000000-O5FFFFFFFFFF 
Local exchange identifier .. . 056nnnnn 05600000-O56FFFFF, 
*LIND 

Initial connection *DIAL *DIAL, *ANS 


Figure 108. Node ID definition for AS/400 


The corresponding VTAM definition is as follows: 


?LINKNAME? PU ADDR=04, X 
CPNAME=?LUNAME?, X 
IDBLK=056, * MUST BE 056 FOR AS/400 * X 
IDNUM=nnnnn, * ANY 5 HEX DIGITS : X 


MODETAB=?MODETAB? 
?7LUNAME? LU LOCADDR=0,DLOGMOD=#INTER 
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A.3 Node ID for Networking Services/DOS 


Networking Services/DOS calls the block number the b/ock_{D and the ID number 
the [D. The block_ID is settable but defaults to 075. In the example below, the 
“bbb” values must match in VTAM and Networking Services/DOS. 


NSON ?NETWORK?. ?LUNAME?, bbbnnnnn 
The corresponding VTAM definition is as follows: 


?LINKNAME? PU ADDR=04, X 
CPNAME=?LUNAME?, X 
IDBLK=bbb, * DEFAULTS T0 075 X 
IDNUM=nnnnn, * ANY 5 HEX DIGITS 7 X 


MODETAB=?MODETAB? 
?LUNAME? = LU LOCADDR=0,DLOGMOD=#INTER 


Note: For Networking Services/DOS, the LU name and CP name are the same. 
The modetable must include the name #INTER. 


A.4 Node ID in OS/2 Extended Services 


OS/2 Extended Services calls the ID number the nodeid and the block number is 
FIXED at OSD. You MUST tell the VTAM system programmer to set the IDBLK 
to 05D. Below is the example Local Node Characteristics window and NDF 
excerpt. 


Required Features: 
Network ID: 
Local node name: 
Node type: 
o End Node to Network Node Server 
o End Node - No Network Node Server 


o Network Node 


Your network node server address: ?LANADDRESS? 


Optional Features 


Local Node ID 050 nnnnn 
Local Node Alias Name — 
Comment Configuration is Fun! 


Activate Attach Manager at start up 


Figure 109. Local Node Characteristics for Extended Services 
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define local cp fq _cp_name(?NETWORK?.?LUNAME?) 
cp_alias(mylu) 
node _id(x'nnnnn') 
node _type(?NODETYPE?) ; 


Figure 110. NDF file excerpt DEFINE LOCAL CP with nodeid 


The corresponding VTAM definition is as follows: 


?LINKNAME? PU ADDR=04, 
CPNAME=?LUNAME?, 
IDBLK=05D, * MUST BE 05D FOR EXT. SVCS.* 
IDNUM=nnnnn, * ANY 5 HEX DIGITS = 


MODETAB=?MODETAB? 
?LUNAME? LU LOCADDR=0,DLOGMOD=#INTER 
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Appendix B. The 3174 Establishment Controller and the 3172 
Interconnect Controller 


The purpose of this appendix is to direct the reader that is interested in using 317x 
controllers to connect APPC partners. 


In the APPC/MVS, APPC/VM and CICS sections of this configuration guide, the 
3745 Communications Controller provides access from the LAN to the IBM 
mainframe. A 3174 Establishment Controller or a 3172 Interconnect Controller can 
also provide gateway function. Here we refer you to other publications for config- 
uration information about these controllers. 


In the case of the 3174, where you go will depend on the level of microcode oper- 
ating in the 3174 (1.e. the configuration support level). 


If using 3174 Configuration Support C, then the 3/74 APPN Implementation Guide, 
publication number GG24-3702, 1s recommended. It details APPN support in the 
3174 and features twelve example scenanos. Each scenario includes configuration 
definitions at all levels (LAN attached node, 3174 and the mainframe) and display 
commands examples. 


When the 3174 1s loaded with earlier versions of microcode (Config A and Config 
B), the reader should obtain Experiences of Connecting APPC/PC with CICS/VS via 
the 3174 Token Ring Gateway for end-to-end definition examples as well as opera- 
tion, and problem determination information. The publication number is 
GG66-0287. 


End-to-end configuration definitions are provided and installation considerations are 


discussed in L’sing the 3/72 for LAN to Host Connectivity, publication number 
SG22-1053. 
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Appendix C. Working with Dependent LUs in OS/2 


There are some situations where independent LUs just won’t work. Take as an 
example a 3174 serving as a token-ring gateway for an MVS host. VIAM Version 
3.3 for MVS will reject a Bind from the 3174 or any of it’s downstream PUs, which 
means you can’t use independent LUs. So. how can you get APPC function? Use 
dependent LUs, of course! 


This appendix describes how to set up VITAM and OS/2 Communications Manager 
(Extended Services or CM/2) to run APING to a host application (CICS, IMS, or 
APPC/MVS) using dependent LUs. We'll wrap up with some networking consider- 
ations and tips. 


Keep in mind the differences between independent and dependent LUs: 
¢ An independent LU 


— requires no VTAM services unless the partner LU 1s somewhere on the 
other side of the VTAM-NCP network, say on another LAN 

— can send a BIND to start a session with any partner LU 

— can have “parallel” sessions to the same partner LU 

— can have sessions with multiple partners at the same time 

— when defined in VTAM has local address (LOCADDR) of 0 


¢ A dependent LU 


— requires VITAM services and an SSCP-LU session to get them 
— cannot start a session by itself 

— can only have one session to one partner at a tume 

— when defined in VTAM has local address greater than 0 


C.1 Configuring VTAM 


Dependent LUs require defining two pieces of information to VTAM: an LU defl- 
nition and a mode entry in a mode table. 


C.1.1 VTAM PU Definition for Workstation Dependent LU 


2LINKNAME? PU ADDR=?PUADDR? ,MODETAB=LU2TABLE ,DLOGMOD=LU2MODE, x 
MAXDATA=1927, .:. 

TERMLU1 LU LOCADDR=02 

TERMLU2 LU LOCADDR=03 

20S2DLU? LU LOCADDR=?LOCADDR? ,MODETAB=?MODETABLE? , DLOGMOD=?MODE? 


Figure 111. WTAM PU Definition with Dependent LU for SDLC Device 


?7LINKNAME? PU CUADDR=?PUADDR? ,MODETAB=LU2TABLE , DLOGMOD=LU2MODE, X 
MAXDATA=1927,... 

TERMLU1 LU LOCADDR=02 

TERMLU2 LU LOCADDR=03 

20S2DLU2 LU LOCADDR=?LOCADDR? ,MODETAB=? HODETABLE? , DLOGMOD=?MODE? 


Figure 112. VTAM PU Definition with Dependent LU for Channel-Attached Device 
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Notes: 


1. The ADDR parameter for switched nodes is irrelevant. For SDLC devices 
(ADDR) and channel-attached devices (CUADDR) this parameter must be 
defined in the device itself to match the VTAM parameter. 


2. If this PU is downstream from a 3174 token-ring gateway, the 7?PUADDR? 
must match the “S” column in question 941 of the 3174 customization.. 


3. This example shows the VTAM sift-down rule in effect. That is, the terminal 
LUs use the modetable and default log mode from the PU statement. You 
could put the APPC mode in the LU2TABLE rather than using a separat 
mode table. | | 


4. 2?0S2DLU?,,2LOCADDR?, and 7MODE? will all be used in the OS/2 definition. 


C.1.2 VTAM Mode Table Entry for Single-Session Mode 


27MODE? =MODEENT LOGMODE=?MODE? , FMPROF=X'13',TSPROF=X'07', Xx 
PRIPROT=X'BO',SECPROT=X'BO' , COMPROT=X'50B5', TYPE=X'00', X 
RUST ZES=X'F7F7' , PSERVIC=X '060200000000000000002C00' 


Figure 113. VTAM Mode Entry for Single-Session Mode 


Notes: 


1. This mode entry specifies that the pnmary LU is contention-winner 
(COMPROT = x’xxBx’), a requirement for CICS autoinstall. 


2. The PSERVIC is required. The x’2C’ specifies that the session supports 
synclevel confirm and single-session only. 


3. This mode entry must be assembled and link-edited with the >MODETABLE? 
member of SYS1.VTAMLIB (MVS), the >MTODETABLE? VTAMLST file 
(VM), or the equivalent file in VSE. 


C.1.3 VTAM Network Identifier (NETID) 
When working with 3174 LIC B as a token-ning gateway, the 3174 does not send 
XIDs from the downstream PUs to VTAM. In particular, VTAM assumes that the 
downstream PUs are in the same network, that is, the downstream PUs have the 
same NETID as VTAM. [f the downstream PU and VTAM have different | 
NETIDs, communication cannot take place. 


The VTAM NETID 1s found in ATCSTRxx, the VTAM start options list. 


C.2 Configuring the Dependent LU in Communications Manager 


Configuring dependent LUs in Communications Manager involves not only the 
local LU but also the partner LU and the logical link. Below are definitions from a 
Communications Manager .NDF file. 
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C.2.1 Defining the Dependent LU in OS/2 


DEFINE _LOCAL_LU LU _NAME(?0S2DLU?) 
DESCRIPTION(Dependent LU for PU 2.0 host gateways) 
LU ALIAS (?LUALIAS?) 
NAU_ADDRESS (?LOCADDR?) ; 


Figure 114. OS/2 Local Dependent LU Definition 


Notes: 
1. 2LOCADDR? must match that in VTAM and must be greater than zero. 
2. The alias of the local LU, 7 LUALIAS?, can be mixed-case. 


C.2.2 Defining the Host LU to OS/2 


DEFINE PARTNER LU FQ PARTNER LU _NAME(?HOSTNET?.?HOSTLU?) 
PARTNER LU ALIAS(?PLUALIAS?, ?PLUal ias?) 
PARTNER LU UNINTERPRETED_NAME (2?HOSTLU?) 
MAX MC_LL SEND SIZE(32767) 
CONV SECURITY VERIFICATION(NO) 
PARALLEL_ SESSION SUPPORT (NO) ; 


Figure 115. OS/2 Partner LU Definition 


Notes: 


1. If PHOSTNET? 1s different from the local NETID, you must code a cross- 
domain resource (CDRSC) definition in VTAM and name it PHOSTLU?. 


2. OS/2 allows you to specify several different aliases for partner LUs. Here we 
show one alias in all upper-case and one in mixed-case. 


3. CM sends the partner LU uninterpreted name to VTAM to start the BIND 
process. This parameter 1s required. 


4. The parallel session support NIUST be NO for dependent LUs. 


C.2.3 Defining the OS/2 Link and PLU Location 


You must tell Communications Manager where to find the partner LU. This 
involves the link definition to (in our example) the 3174 gateway. 


DEFINE LOGICAL_LINK LINK NAME(2GWLINK?) 
DESCRIPTION(Host gateway) 
FQ_ADJACENT_CP_NAME(2NETWORK? . ?GWCP? ) 
ADJACENT NODE_TYPE(LEN) 

DLC_NAME (IBMTRNET) 
ADAPTER_NUMBER (0) 
DESTINATION ADDRESS (?LANADDRESS?) 
CP_CP_SESSION SUPPORT (NO) 
ACTIVATE_AT_STARTUP(YES) 

SOLICIT SSCP_SESSION(YES) ; 


DEFINE PARTNER LU_LOCATION FQ PARTNER LU_NAME(?HOSTNET?. 2HOSTLU?) 
WILDCARD ENTRY (NO) 
FQ OWNING CP_NAME(2NETWORK?.?GWCP?) 
LOCAL_NODE_NN SERVER(NO) ; 


Figure 116. OS/2 Link and PLU Location Definitions 
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~ Notes: 


1. Communications Manager uses the adjacent node’s CP name, 7?GWCP?, as a 
dummy name when the adjacent node type is LEN. However, for smoother 
migration to APPN use the rules in C.4, “Additional Tips and Details” on 
page 153. 


2. You must set SOLICIT SSCP_SESSION(YES) because the dependent LU 
requires one. : 


3. If this workstation communicates with several host LUs, you may wish to set 
WILDCARD _ENTRY(PARTIAL). See C.4, “Additional Tips and Detaus” 
on page 153 for an example. 


C.2.4 Defining the OS/2 Single-Session Mode 


DEFINE MODE MODE _NAME(?MODE?) 
DESCRIPTION(Single-session mode) 
COS _NAME(#INTER  ) 
DEFAULT RU SIZE(YES) 
RECEIVE PACING WINDOW(4) 
HAX NEGOTIABLE SESSION LIMIT(1) 
PLU MODE SESSION LIMIT(1) 
HIN CONWINNERS SOURCE(1) ; 


Figure 117. OS/2 Single-Session Mode Definition 


Notes: 
l. The mode name ?MIODE? must match that in VTAM. 


2. Set MIN_CONWINNERS_ SOURCE(1) if programs on the workstation will 
start most of the APPC conversations. Set this to (0) if the host application | 
Starts most of the conversations (for example, ImagePlus/ESA or NetView Dis- 
tribution Manager). 


C.3 Running APING 


Finally, to run APING, issue the following two commands from an OS/2 
command prompt: 


fiC:\" set appcllu=?LUALIAS? 
fiC:\"“ aping -n -m ?MODE? 2?PLUalias? 


The environment variable APPCLLU tells CPI-C which local LU to use for the 
session. If you don’t set this variable, CPI-C uses the default LU. The default LU 
is the control point LU. (You can change this; see the tips in C.4, “Additional Tips 
and Details” on page 153.) 


Remember when setting APPCLLU and when running APING that aliases are 


case-sensitive. You must specify the mode here because APING will try to use 
#INTER, which will in turn try (and fail) to set up parallel sessions. 
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C.4 Additional Tips and Details 


C.4.1 Tips 


C.4.2 Minutiae 


Here are some other tricks: 
¢ Choosing the CP names on DEFINE LOGICAL LINK 


— If your gateway is a 3745, use the VTAM SSCP name. When you migrate 
to APPN, the SSCP name becomes the CP name of the VTAM-NCP 
“composite network node”. 

— If your gateway is anything else, use the CP name of the gateway node 
(3174, 3172, CM/2,...). When you migrate to APPN, the gateway itself 
becomes the APPN network node. (The 3172 network node function is a 
statement of direction as of 2/94.) 


¢ Using wildcards to reduce PLU location definitions 


If your workstation communicates with many host LUs, you can get by with 
one statement coded like this: 


DEFINE PARTNER LU LOCATION FQ PARTNER LU NAME(?PARTNERNET?.) 
WILDCARD_ENTRY (PARTIAL) 
FQ OWNING CP_NAME(2NETWORK? . ?GWCP?) 
LOCAL_NODE_NN SERVER(NO) ; 


Communications Manager will route requests for all LUs in the 
2?PARTNERNET? network to the gateway link. 


¢ Changing the default LU 


If you never use the parallel session capability of the CP LU, then you can 
change the default LU (and eliminate the “set APPCLLU” step) by coding this 
line in the DEFINE_DEFAULTS stanza: 


DEFINE DEFAULTS DEFAULT LOCAL LU ALIAS(?LUALIAS?) 


¢ Defining VTAM cross-domain resources 
KKEKEKKKEKEKREKKEKEKREKEKKKKERKKREEEREKEEKEKEKREEKKEKRKKKKKEKEKKKKEKK 


* THE LOCAL NETWORK ID IS NET1, LOCAL VTAM IS NICDRM1 * 


KKKEKRKEKKEKKKEKKEKEKREKKEKEKKKEREEKRREKERKEREKRKEKEKRKEKRKEKEKKEKEKKER 

2CDRSCMAJ? VBUILD TYPE=CDRSC 

?HOSTLU1? CDRSC CDRM=NICDRM1 * Host LU1 on some other NET1 VTAM 
?HOSTNET? NETWORK NETID=?HOSTNET? 

2HOSTLU? CDRSC ISTATUS=ACTIVE * Host LU in HOSTNET network 


To connect two VIAMs with different network IDs requires the SNA Network 
Interconnect (SNI) product with one VITAM in each network connected to a 
“gateway” NCP. VTAMs are known in the network by their Cross-Domain 
Resource Manager (CDRM) names. VIAM Version 3.4 and later treat ALL - 
independent LUs as cross-domain resources. 


One of the limitations of dependent LUs is that you can’t start a session from your 
dependent LU to an LU in another OS/2 system. The partner system MAY be 
able to start a session to the dependent LU if it has an independent LU. In fact, 
from a dependent LU you can only initiate sessions to host LUs or LUs in nodes 
(like the AS/400) that respond to the VTAM message CDCINIT. The node 
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responds to the CDCINIT with a BIND to the onginating LU (in OS/2 in our 
example). | | 


If all you want to do is APPC to one host application at a time, dependent LU 
support is adequate. If you want to do a lot of APPC with multiple host applica- 
tions, then you will need several LUs per workstation. This makes working with 
CPI-C somewhat tedious, since CPI-C uses the “default” LU. This 1s nice because 
the application doesn’t have to know anything about the local configuration. 
However, with lots of dependent LUs, your applications will need to use different 
local LUs. This is just one more reason to use one independent LU that can have 
multiple sessions with multiple partners. 
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Appendix D. CICS: Autoinstalling Parallel Sessions 


Note: CICS/ESA Version 4, announced February 1, 1994, supports autoinstalling 
parallel sessions. See Announcement Letter 294-026 for more details. 


Customers use CICS autoinstall to conserve CICS resources for applications like 
Image + /ESA. Some CICS system programmers (and many IBMers as well) 
believe that autoinstall only works for dependent LUs. However, there are many 
dynamic definition features in VTAM and APPN that only work with independent 
LUs and cannot be used by dependent LUs. It would be very nice to get the bene- 
fits of both autoinstall and independent LUs. Well, YOU CAN! Really, it was 
possible all along; it just wasn’t easy to figure out. Here’s how. If you know all 
about CICS autoinstall just skip to D.1.2, “WTAM Mode Table Entry” on 

page 156. Otherwise, the next few paragraphs serve as an introduction. 


Many APPC platforms can build partner definitions automatically whenever an 
unknown partner tnes to connect. Automatic definition means less administrative 
work, fewer mistakes, and happier users. CICS calls this function “‘autoinstall” and 
CICS has had it for a long trme. That’s the good news. The bad news is that CICS 
can autoinstall only single-session “terminals” and VTAM must start the process. 


In SNA terms a CICS terminal is typically a dependent LU and SNA (VTAM in 
particular) works very well with dependent LUs. However, SNA with Advanced 
Peer-to-Peer Networking (APPN) works better with independent LUs that send 
BINDs directly and don’t need VTAM. A typical workstation cannot just send a 
BIND to CICS; there must be a CINIT message (pronounced “see-init”) from 
VTAM in order to start the autoinstall process. 


So, the task boils down to two steps 


1. Setting up Communications Manager or Networking Services/DOS to properly 
respond to CICS 


2. Starting the process in VAM, either through system definition or operator 


command. 


For complete details on what happens between dependent LUs, VITAM, and CICS, 
see D.5, “Autoinstall Details” on page 159. If you just want the configuration and 
operation information, read on. 


D.1 Setting up CICS and VTAM for Autoinstall 


There are three events that will cause VTAM to send a CINIT to CICS (starting 
the autoinstall process): 


1. An LU statement 1s coded with the LOGAPPL(?CICSLU?) parameter and the 
LU becomes active (CICSLU 1s the CICS applid or region name). 


2. A VITAM operator issues a 
VARY NET ,LOGON=?CICSLU? , ID=?ILU?, LOGMODE=2MODE? 


command (2?ILU? is the independent LU name, 7MODE? is a mode with 
parameters that match the CICS defaults for the LU62 terminal). 
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3. A dependent LU sends an INIT_SELF to VTAM naming ?CICSLU? as the 
“partner uninterpreted name.” 


Note that only item 3 explicitly excludes independent LUs. So, to bring CICS into 
the dynamic world of APPN, all we have to do is implement method | or 2. 


D.1.1 CICS Model Definitions | | 
The following example shows what happens with the CICS/ESA V3R3 default defi- 
nitions. The two pertinent CICS resource definitions are LU62 TERMINAL in 
group DHFTERM and DFHLU62T TYPETERM in group DFHTYPE. You 
can’t change the CICS defaults; these screens are shown for information only. 


TERMINAL : LU62 

GROUP : DFHTERM 

DESCRIPTION 

AUTINSTMODEL : ONLY NO | YES | ONLY 
AUTINS TNAME : DFHLU62T 
TERMINAL IDENTIFIERS 


TYPETERM : DFHLU62T 

NETHAME : LU62 
SESSION SECURITY 

SECURIT TYNAME 

ATTACHSEC : LOCAL LOCAL | IDENTIFY | VERIFY | PERSISTENT | MIXIOPE 
BINDPASSWORD PASSWORD NOT SPECIFIED 

BINDSECURITY : NO NO | YES 


Figure 118. LU62 TERMINAL Definition in Group DFHTERM 


You may wish to change the ATTACH secunty to VERIFY (for password 
checking on all transactions) or PERSISTENT (for OS/2). To do so, you must 
create a new model TERMINAL definition and a new model TYPETERM defi- 
nition. | 


Figure 119 shows the important lines in the TYPETERM definition used for 
APPC autoinstall. | 


TYPETERM : DFHLU62T 

GROUP : DFHTYPE 
DESCRIPTION 

RESOURCE TYPE 
DEVICE : APPC 

SESSION PROPERTIES 

ASCII : NO NO {7 {| 8 
SENDSIZE : 02048 0-30720 


RECEIVESIZE : 02048 0-30720 
BRACKET : YES YES | NO 
LOGHODE : 


Figure 119. DFHLU62T TYPETERM Definition in Group DFHTYPE 


D.1.2 VTAM Mode Table Entry 
~The key VTAM definition is the mode name in the LU’s default mode table. You. 
must create this mode entry or one like it. Below is the assembler source for the 
?MODE? mode. Add this entry to your mode table source file, assemble it, and 
link-edit the result with SYS1.VTAMLIB. 
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2MODE? MODEENT LOGMODE=2MODE? , FMPROF=x'13' , TSPROF=X'07", X 
PRIPROT=X'BO' ,SECPROT=X'BO', COMPROT=X'50B5', TYPE=X'Q0', X 
RUST ZES=X'8888' , PSERVIC=X '060200000000000000002C00' 


Figure 120. Sample Mode Entry for Single-Session, PLU Contention-Winner Mode 


Notes: 


1. The common Function Management protocols (COMPROT) is x’50B5’. The 
third character must be x’B’ to indicate “bind-sender (CICS) is contention- 
winner.” | 


2. CICS always tnes to be the contention-winner for the session but accepts what- 
ever the partner LU sets in the BIND response. 


Once you have successfully link-edited the mode table, update the working mode 
table with the command 


modify net,table,option=load,newtab=?MODETABLE? 


D.2 Autoinstalling OS/2 Communications Manager ILUs 


OS/2 Communications Manager can accept being contention-loser when the 
session-limit is 1. If an OS/2 application tres to allocate a conversation on the 
session and the session is not in use, Communications Manager will send a no-op 
message to CICS with bits in the header that say (in effect) “I want to use this 
session, is it okay?” and CICS wul respond, “It’s okay.” Then Communications 
Manager will return control to the program and the transaction program will 
proceed. 


D.2.1 Starting the Autoinstall 
To autoinstall the OS/2 LU, do one of the following: 


¢ code the VTAM LU statement with a LOGAPPL parameter. For example, 
20S2LU? LU LOCADDR=0, ISTATUS=ACTIVE, DLOGMOD=?MODE? , LOGAPPL=?CICSLU? 
e issue the VTAM operator command 


v net, logon=?CICSLU? , id=?0S2LU?2 , | ogmode=?MODE? 


D.3 Setting Up OS/2 CM for Autoinstall 


There are two cases to consider for OS/2 system definition. 


1. CICS always starts the APPC conversation; this happens with Image + /ESA, 
for example. You need no additional definitions in Communications Manager. 


2. OS/2 applications will start conversations with CICS transactions. This will 
require a partner LU definition that specifies a session limit of 1 and the mode 
definition. 
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D.3.1 Defining the Mode Name 


To make OS/2 the contention-winner on the single session, you must create a mode 
definition (see below). The session limits must be coded exactly as shown; the RU 
sizes and pacing values can be changed. 


DEFINE MODE MODE_NAME(?MODE?) 
-_-DESCRIPTION(For CICS autoinstall test) 
COS NAME(#INTER ) 
DEFAULT RU SIZE(YES) 
RECEIVE PACING WINDOW(4) 
MAX NEGOTIABLE SESSION LIMIT(1) 
PLU MODE SESSION LIMIT(1) 
MIN CONWINNERS SOURCE(1); 


Figure 121. Contention-Winner Mode Definition for Communications Manager 


D.3.2 Defining the Partner LU (CICS) 


DEFINE PARTNER LU FQ PARTNER LU_NAME(?CICSNET?.?CICSLU?) 
PARTNER_LU _ALIAS (?PLUALIAS?, ?plualias?) 
MAX_MC_LL_SEND_SIZE(32767) 

CONV SECURITY VERIFICATION (NO) 
PARALLEL_SESSION SUPPORT (NO) ; 


Figure 122. Communications Manager Partner LU Definition 


Notes: 


1. If ?>CICSNET? 1s different from the local NETID, you must code a cross- 
domain resource (CDRSC) definition in VTAM and name it ?CICSLU?. 


2. Communications Manager allows you to specify several different aliases for 
partner LUs. Here we show all upper-case and all lower-case aliases. 


3. The parallel session support NIUST be NO for CICS autoinstall. 


D.4 Autoinstalling Networking Services/DOS ILUs 
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This requires Networking Services/DOS at CSD level IP00898 or later. Networking 
Services/DOS (version 1.0 with CSD and version 1.1) will always try to be the con- 
tention winner. Figure 123 shows a sample MODE.NSD containing a proper 
single-session mode definition. 


// Rev Maximum Minimum 
Maximum Pacing Negotiable Negotiable 
//{ Mode Name RU Size Window Sessions Conwinners 


awoweeee = w@ auweee = = moe ee @ oe ower eree ee a2 @ — — @ oe oe ow ow om oe ow 


SNASVCMG 256 1 bat ] 
BLANK ~_ (oe 8 4 
#BATCH 3 8 4 
#INTER . 7 8 4 
//  ?MODE? is for single-session CICS autoinstal] 
2MODE? 1024 3 1 1 


Figure 123. Contention-Winner Mode Definition for Networking Services, DOS 
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As with OS/2, the RU size and pacing windows are tunable, the session limits are 
not. Autoinstall will not work if the mode name is omitted from the MODE.NSD 
file. 


D.4.1 Starting the Autoinstall 
| To autoinstall the Networking Services/DOS LU, do one of the following: 


¢ code the VTAM LU statement with a LOGAPPL parameter. For example, 
?2NSDLU? LU LOCADDR=0, ISTATUS=ACTIVE ,DLOGMOD=?MODE? , LOGAPPL=?CICSLU? 


e issue the VITAM operator command 
v net, logon=?CICSLU?, 1 d=?NSDLU?, logmode=? MODE? 


Here, 7NSDLU? must match the Networking Services/DOS LU definition in the 
NSDN statement in the CONFIG.NSD file. 


NSON 2?NETWORK?.?NSDLU? 


D.5 Autoinstall Details 


APPC sessions start with one LU sending a BIND to the partner LU. The partner 
LU can use information in the BIND to completely identify the ongin LU. There- 
fore most platforms use the BIND to start the automatic definition process. This 
approach does not work for dependent LUs because dependent LUs can’t send 
BINDs. 


CICS needed a solution that worked for dependent LUs. Fortunately, whenever 
someone at a 3270 terminal (a dependent LU to VTAM and CICS),needs to 
connect to CICS, VTAM sends to CICS a message called a “control initiate” 
(CINIT). The CINIT contains the terminal’s LU name and all the other parame- 
ters that go ina BIND. If all those parameters match what CICS wants to send, 
then CICS will build a BIND to the target LU and send it. 


In APPC, dependent LUs automatically send a message called INIT_SELF to 
VTAM, which in turn causes VIT'AM to send a CINIT to CICS. Independent LUs 
wil try to send a BIND to start a session and CICS will reject BINDs from LUs for 
which it does not have an existing CONNECTION or TERMINAL definition. 


So, our problem becomes “How can I get VTAM to generate a CINIT for an inde- 
pendent LU?’ or, to use VTAM terminology, “How can I logon an independent LU 
to CICS?” There are only two ways to do this: issue the VTAM operator 
command “v net,logon=...” or code the LOGAPPL parameter on the LU definition 
statement. D.1, “Setting up CICS and VTAM for Autoinstall” on page 155 
descnbes the operational steps to make this work. 


D.6 References 
VTAM Operation VTAM Resource Definition Reference 
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